select

Emits a value from exactly one of a set of sub-schemas, selected at random. By default, each sub-schema has an equal chance of being selected. However, weights can be assigned to each to adjust the probability of selection.

#Inputs

An array of objects that must include a schema field and an optional weight field.

#Examples

Alternates between the string "one" and the number 2.

{
  "type": "select",
  "options": [
    {
      "schema": {
        "type": "constant",
        "value": "one"
      }
    },
    {
      "schema": {
        "type": "constant",
        "value": 2
      }
    }
  ]
}

Emits a positive integer 80% of the time, and null 20% of the time.

{
  "type": "select",
  "options": [
    {
      "weight": 4,
      "schema": {
        "type": "number",
        "minimum": 0,
        "scale": 0
      }
    },
    {
      "weight": 1,
      "schema": {
        "type": "constant",
        "value": null
      }
    }
  ]
}