diff --git a/javascript.md b/javascript.md index 281e793..faf679a 100644 --- a/javascript.md +++ b/javascript.md @@ -21,7 +21,7 @@ Getting started {.cols-3} ### Introduction JavaScript is a lightweight, interpreted programming language. -- [Learn X in Y minutes](https://learnxinyminutes.com/docs/javascript/) _(learnxinyminutes.com)_ +- [JSON cheatsheet](/json) _(quickref.me)_ - [Regex in JavaScript](/regex#regex-in-javascript) _(quickref.me)_ diff --git a/json.md b/json.md new file mode 100644 index 0000000..1bcb0d9 --- /dev/null +++ b/json.md @@ -0,0 +1,349 @@ +--- +title: JSON +date: 2021-09-14 18:26:55 +icon: icon-json +background: bg-gray-700 +tags: + - config + - format +categories: + - Programming +intro: | + This is a quick reference cheat sheet for understanding and writing JSON format configuration files. +--- + +Getting started {.cols-3} +--------------- + + +### Introduction + +[JSON](https://json.org/) is a lightweight text-based open standard designed for human-readable data interchange. + +- JSON stands for JavaScript Object Notation +- JSON is easy to read and write. +- JSON is language agnostic data-interchange format +- JSON filename extension is `.json` +- JSON Internet Media type is `application/json` +{.style-round} + + + +### Examples + +```json +{ + "name": "Jason", + "age": 39, + "height": 1.92, + "gender": "M", + "salary": 70000, + "married": true, + "children": [ + {"name": "Tom", "age": 9, "gender":"M"}, + {"name": "Ava", "age": 7, "gender":"F"} + ] +} +``` + + +### Types + +| Type | Description | +|-----------|-----------------------------------------| +| `Number` | Double precision floating-point | +| `String` | Series of characters | +| `Boolean` | `true` or `false` | +| `Array` | Ordered sequence of values | +| `Value` | String, Number, Boolean, null etc | +| `Object` | Unordered collection of key/value pairs | +| `null` | Null or Empty | + + + + +### String {.row-span-3} +| | | +|------|----------------------------| +| `\"` | Double quote | +| `\\` | Backslash | +| `\/` | Forward slash | +| `\b` | Backspace | +| `\f` | Form feed | +| `\n` | Newline | +| `\r` | Carriage return | +| `\t` | Tab | +| `\u` | Trailed by four hex digits | + +#### Examples +```json {.wrap} +{ + "url": "https://quickref.me", + "msg" : "Hi,\n\"QuickRef.ME\"", + "intro": "Share quick reference and cheat sheet for developers." +} +``` +#### Invalid String +```json +{ "foo": 'bar' } +``` +Have to be delimited by double quotes + + + +### Number {.row-span-2} + +| Type | Description | +|------------|----------------------------------------| +| `Integer` | Digits 1-9, 0 and positive or negative | +| `Fraction` | Fractions like 0.3, 3.9 | +| `Exponent` | Exponent like e, e+, e-, E, E+, E | + +#### Examples +```json +{ + "positive" : 12, + "negative" : -1, + "fraction" : 10.25, + "exponent" : 1.0E+2, + "zero" : 0 +} +``` +#### Invalid Number +```json +{ "foo": 0xFF } +``` +In JSON you can use only Decimal Literals + + + +### Objects + +```json +{ + "color": "Purple", + "id": "210", + "composition": { + "R": 70, + "G": 39, + "B": 89 + }, + "empty_object": {} +} +``` + +Multiple key/value pairs separated by a comma + + + +### Arrays +```json +[1, 2, 3, 4, 5] +``` +Begins with `[` and ends with `]` + + + +### Array of objects +```json +{ + "children": [ + {"name": "Jimmy Smith", "age": 15}, + {"name": "Sammy Sosa", "age": 12} + ] +} +``` + + +### Object of arrays +```json +{ + "attributes": ["a1", "a2"], + "methods": ["getter", "setter"], + "empty_array": [] +} +``` + + +### 2D Array +```json +{ + "my_sequences": [ + [1, 2, 3], + [4, 5, 6], + [7, 8, 9, 0], + [10, 11] + ] +} +``` + + +### Object of objects + +```json +{ + "Mark McGwire": { + "hr": 65, + "avg": 0.278 + }, + "Sammy Sosa": { + "hr": 63, + "avg": 0.288 + } +} +``` + +### Nested +```json +{ + "Jack": { + "id": 1, + "name": "Franc", + "salary": 25000, + "hobby": ["a", "b"], + "location": { + "country": "A", "city": "A-A" + } + } +} +``` + + + +Access JSON in JavaScript {.cols-3} +------------------------- + +### Access Object + +```javascript +let myObject = { + "name": "Jason", + "last": "Doe", + "age": 39, + "gender": "M", + "salary": 70000, + "married": true +}; +``` +---- + +| | | +|----------------------|-----------| +| `myObject.name` | "Jason" | +| `myObject["name"]` | "Jason" | +| `myObject.age` | 39 | +| `myObject.other` | undefined | +| `myObject[0]` | undefined | + + + +### Access Nested {.row-span-2} +```javascript +let myObject = { + "ref": { + "name": 0, + "last": 1, + "age": 2, + "gender": 3, + "salary": 4, + "married": 5 + }, + "jdoe": [ + "Jason", + "Doe", + 39, + "M", + 70000, + true + ], + "jsmith": [ + "Tom", + "Smith", + 42, + "F", + 80000, + true + ] +}; +``` +---- + +| | | +|--------------------------|--------------------------| +| `myObject.ref.age` | 2 | +| `myObject["ref"]["age"]` | 2 | +| `myObject.jdoe` | ["Jason", "Doe", 39 ...] | +| `myObject.jsmith[3]` | "F" | +| `myObject[1]` | undefined | + + + +### Access Array of Objects {.row-span-2} +```javascript +let myArray = [ + { + "name": "Jason", + "last": "Doe", + "age": 39, + "gender": "M", + "salary": 70000, + "married": true + }, + { + "name": "Tom", + "last": "Smith", + "age": 42, + "gender": "F", + "salary": 80000, + "married": true + }, + { + "name": "Amy", + "last": "Burnquist", + "age": 29, + "gender": "F", + "salary": 60000, + "married": false + } +]; +``` +---- + +| | | +|---------------------|----------------------------| +| `myArray[0]` | `{`"fist": "Jason", ...`}` | +| `myArray[1].name` | "Tom" | +| `myArray[1][2]` | 42 | +| `myArray[3]` | undefined | +| `myArray[3].gender` | TypeError: Cannot read... | + + + + +### Access Array +```javascript +let myArray = [ + "Jason", + "Doe", + 39, + "M", + 70000, + true +]; +``` +----- + +| | | +|--------------|-----------| +| `myArray[1]` | "Doe" | +| `myArray[5]` | true | +| `myArray[6]` | undefined | + + + + +Also see +-------- +- [JSON](https://www.json.org/json-en.html) _(json.org)_ +- [JSON Editor Online](http://jsoneditoronline.org/) _(jsoneditoronline.org)_ +- [Convert 2d JSON to x](https://tableconvert.com/) _(tableconvert.com)_