How to read the reference documentation
Please take a moment to familiarize yourself with the types of symbols you'll see throughout the technical documentation.
Type Annotations#
This shorthand is used to indicate the types of arguments, return values, and object properties.
Annotation | Meaning |
---|---|
[day] | The parameter is optional. If it is not supplied, it will be undefined . |
[day="Monday"] | The parameter is optional, but will be supplied a default value if not provided. |
?Array | Type can be an Array OR null . |
!Array | Type must be an Array; cannot be null . Primitive types (string , number , boolean ) imply ! unless explicitly denoted otherwise with ? . |
`string | number` |
{foo:number, bar:string} | Type is an object with two properties: foo , which is type number ; and bar , which is type string . |
string[] | Type is an array of strings. |
Array<string> | Type is an array of strings. |
Promise<string> | Type is a Promise that is asynchronously fulfilled with a string. |
* | Can be any type. NOTE: In this early stage, * is sometimes used as a placeholder for incomplete documentation. |