Skip to content

Array Slices

This features allows you to select array items with a specified range.

INFO

Slices works similar to the Array.prototype.slice(). See MDN Docs for more info

Colon

The colon token along with brackets [:] is used to slice arrays.

$.friends[2:4]

Types

There three types of slices you can use.

Left Slice: $.friends[1:]

Right Slice: $.friends[:4]

Full Slice: $.friends[2:5]

INFO

Negative slicing is supported as well.


Sample Data

json
{
  "array": [1, 2, 3, 4, 5]
}

Queries

ts
// Select first 3 items
query.run("$.array[:3]") // [1, 2, 3]

// Select last 3 items
query.run("$.array[-3:]") // [3, 4, 5]

// Select items from index 1 to 3
query.run("$.array[1:3]") // [2, 3]

DANGER

Empty slices are not supported: $.friends[:]