Numbers

Rounding is half-to-even (round(2.5) is 2), matching JSONata and XPath.

numberConversion

number(value: string | number | boolean): number

Parses strings and booleans into a number (`undefined` if not parseable).

formatBaseConversion

formatBase(value: number, radix?: number): string

Renders an integer in the given radix (2–36, default 10).

floorRounding

floor(value: number): number

Rounds down to the nearest integer.

ceilRounding

ceil(value: number): number

Rounds up to the nearest integer.

roundRounding

round(value: number, precision?: number): number

Rounds to `precision` digits, half-to-even like JSONata.

absMath

abs(value: number): number

Absolute value.

powerMath

power(base: number, exponent: number): number

`base` raised to `exponent`.

sqrtMath

sqrt(value: number): number

Square root (`undefined` for negative input).

randomRandom

random(): number

Pseudo-random number in [0, 1).

Conversion

number

number(value: string | number | boolean): number

Parses strings and booleans into a number (undefined if not parseable).

taxRate: number(item.taxRateStr)

formatBase

formatBase(value: number, radix?: number): string

Renders an integer in the given radix (2–36, default 10).

hex: formatBase(color.value, 16)

Rounding

floor

floor(value: number): number

Rounds down to the nearest integer.

pages: floor(catalog.items / pageSize)

ceil

ceil(value: number): number

Rounds up to the nearest integer.

pages: ceil(catalog.items / pageSize)

round

round(value: number, precision?: number): number

Rounds to precision digits, half-to-even like JSONata.

total: round(item.price * item.qty, 2)

Math

abs

abs(value: number): number

Absolute value.

delta: abs(order.total - order.paid)

power

power(base: number, exponent: number): number

base raised to exponent.

area: power(shape.side, 2)

sqrt

sqrt(value: number): number

Square root (undefined for negative input).

side: sqrt(shape.area)

Random

random

random(): number

Pseudo-random number in [0, 1).

jitter: random() * 100

Playground

Mapping✔Playground ↗

input item: { price: number, qty: number, taxRate: string }

map {
  total: round(item.price * item.qty * (1 + number(item.taxRate)), 2),
  parsed: number("42.5"),
  hex: formatBase(255, 16),
  root: sqrt(81),
}

input item: { price: number, qty: number, taxRate: string } map { total: round(item.price * item.qty * (1 + number(item.taxRate)), 2), parsed: number("42.5"), hex: formatBase(255, 16), root: sqrt(81), }

Input JSON

{ "price": 19.99, "qty": 3, "taxRate": "0.2" }

{ "price": 19.99, "qty": 3, "taxRate": "0.2" }

Output

{
  "total": 71.96,
  "parsed": 42.5,
  "hex": "ff",
  "root": 9
}

inferred type{ total: number; parsed: number; hex: string; root: number }