75 lines
1.8 KiB
Markdown
75 lines
1.8 KiB
Markdown
<!--meta-description
|
|
Documentation on m.parseQueryString(), which converts a string like "a=1&b=2" into an object like {a: "1", b: "2"}
|
|
-->
|
|
|
|
# parseQueryString(string)
|
|
|
|
- [Description](#description)
|
|
- [Signature](#signature)
|
|
- [How it works](#how-it-works)
|
|
|
|
---
|
|
|
|
### Description
|
|
|
|
Turns a string of the form `?a=1&b=2` to an object
|
|
|
|
```javascript
|
|
var object = m.parseQueryString("a=1&b=2")
|
|
// {a: "1", b: "2"}
|
|
```
|
|
|
|
---
|
|
|
|
### Signature
|
|
|
|
`object = m.parseQueryString(string)`
|
|
|
|
Argument | Type | Required | Description
|
|
------------ | ------------------------------------------ | -------- | ---
|
|
`string` | `String` | Yes | A querystring
|
|
**returns** | `Object` | | A key-value map
|
|
|
|
[How to read signatures](signatures.md)
|
|
|
|
---
|
|
|
|
### How it works
|
|
|
|
The `m.parseQueryString` method creates an object from a querystring. It is useful for handling data from URL
|
|
|
|
```javascript
|
|
var data = m.parseQueryString("a=hello&b=world")
|
|
|
|
// data is {a: "hello", b: "world"}
|
|
```
|
|
|
|
#### Boolean type casting
|
|
|
|
This method attempts to cast boolean values if possible. This helps prevents bugs related to loose truthiness and unintended type casts.
|
|
|
|
```javascript
|
|
var data = m.parseQueryString("a=true&b=false")
|
|
|
|
// data is {a: true, b: false}
|
|
```
|
|
|
|
#### Leading question mark tolerance
|
|
|
|
For convenience, the `m.parseQueryString` method ignores a leading question mark, if present:
|
|
|
|
```javascript
|
|
var data = m.parseQueryString("?a=hello&b=world")
|
|
|
|
// data is {a: "hello", b: "world"}
|
|
```
|
|
|
|
#### Deep data structures
|
|
|
|
Querystrings that contain bracket notation are correctly parsed into deep data structures
|
|
|
|
```javascript
|
|
m.parseQueryString("a[0]=hello&a[1]=world")
|
|
|
|
// data is {a: ["hello", "world"]}
|
|
```
|