104 lines
1.6 KiB
Markdown
104 lines
1.6 KiB
Markdown
|
### Record.JS
|
||
|
|
||
|
- [constructor][1]
|
||
|
- [add][2]
|
||
|
- [find][3]
|
||
|
- [remove][4]
|
||
|
- [count][5]
|
||
|
|
||
|
## constructor
|
||
|
|
||
|
**Parameters**
|
||
|
|
||
|
- `init` **[array][6]** collection to start with
|
||
|
- `opts` **[object][7]**
|
||
|
- `opts.store` **[object][7]** localStorage ID to use
|
||
|
- `opts.debug` **[object][7]** show console logs
|
||
|
|
||
|
**Examples**
|
||
|
|
||
|
```javascript
|
||
|
// create a new record (in-memory)
|
||
|
let pets = new Record();
|
||
|
```
|
||
|
|
||
|
## add
|
||
|
|
||
|
Add record to collection creating an sudo unique id if
|
||
|
one not provided
|
||
|
|
||
|
**Parameters**
|
||
|
|
||
|
- `entry` **[Object][7]** object(s) you want to store
|
||
|
|
||
|
**Examples**
|
||
|
|
||
|
```javascript
|
||
|
// add pet to collection
|
||
|
let dog = pets.add({"name": "Yonkers", "age": 5});
|
||
|
|
||
|
// [{"id": "14rj345k9", "name": "Yonkers", "age": 5}]
|
||
|
```
|
||
|
|
||
|
Returns **[array][6]** record added
|
||
|
|
||
|
## find
|
||
|
|
||
|
Finds records in collection by id or object filter.
|
||
|
|
||
|
**Parameters**
|
||
|
|
||
|
- `key` **([string][8] \| [number][9])** (optional) by id, or object
|
||
|
|
||
|
**Examples**
|
||
|
|
||
|
```javascript
|
||
|
// find all
|
||
|
let all = collection.find();
|
||
|
```
|
||
|
|
||
|
```javascript
|
||
|
// find by id
|
||
|
let record = collection.find(1);
|
||
|
```
|
||
|
|
||
|
```javascript
|
||
|
// filter by object
|
||
|
let dogs = collection.find({"type": "dog"});
|
||
|
```
|
||
|
|
||
|
Returns **[array][6]** matching records
|
||
|
|
||
|
## remove
|
||
|
|
||
|
- **See: [find][10]**
|
||
|
|
||
|
Remove record(s) from collection. Leverages same functionality as `find`
|
||
|
|
||
|
**Parameters**
|
||
|
|
||
|
- `entry` **any** (optional)
|
||
|
|
||
|
**Examples**
|
||
|
|
||
|
```javascript
|
||
|
// remove all records by type
|
||
|
let removed = collection.remove({"type": "cat"});
|
||
|
```
|
||
|
|
||
|
Returns **[array][6]** records removed
|
||
|
|
||
|
## count
|
||
|
|
||
|
Returns **[number][9]** count of records in collection
|
||
|
|
||
|
[1]: #constructor
|
||
|
|
||
|
[2]: #add
|
||
|
|
||
|
[3]: #find
|
||
|
|
||
|
[4]: #remove
|
||
|
|
||
|
[5]: #count
|