Η 101 είναι μια βοηθητική βιβλιοθήκη JavaScript για εργασία με αμετάβλητα δεδομένα σε στυλ συναρτησιακού προγραμματισμού.
Χρήση (Usage)
const isObject = require('101/isObject')
isObject({}) // → true
Κάθε συνάρτηση εκτίθεται ως ξεχωριστό άρθρωμα για ελάχιστο μέγεθος πακέτου.
See: Αποθετήριο 101 στο GitHub
Έλεγχος τύπων (Type Checking)
isObject({})
isString('str')
isRegExp(/regexp/)
isBoolean(true)
isEmpty({})
isFunction(x => x)
isInteger(10)
isNumber(10.1)
instanceOf(obj, 'string')
Αντικείμενα (Objects)
Παραδείγματα
let obj = {}
Ενημέρωση (Update)
obj = put(obj, 'user.name', 'John')
// → { user: { name: 'John' } }
Ανάγνωση (Read)
pluck(name, 'user.name')
// → 'John'
Διαγραφή (Delete)
obj = del(obj, 'user')
// → { }
Συναρτήσεις πρόσβασης (Accessors)
pluck(state, 'user.profile.name')
pick(state, ['user', 'ui'])
pick(state, /^_/)
Η pluck ανακτά μια συγκεκριμένη ένθετη τιμή, ενώ η pick επιστρέφει υποσύνολο του αντικειμένου.
Συναρτήσεις ορισμού (Setters)
put(state, 'user.profile.name', 'john')
See: put
Διαγραφή (Deletion)
del(state, 'user.profile')
omit(state, ['user', 'data'])
Η omit μοιάζει με τη del, αλλά υποστηρίζει ταυτόχρονη αφαίρεση πολλαπλών κλειδιών.
Επαλήθευση διαδρομής κλειδιών (Keypath Verification)
hasKeypaths(state, ['user'])
hasKeypaths(state, { 'user.profile.name': 'john' })
See: hasKeypaths
Τιμές (Values)
values(state)
Συναρτήσεις (Functions)
Συνδυαστές & απλές συναρτήσεις
| Συνάρτηση | Ισοδύναμη έκφραση |
|---|---|
and(x, y) |
x && y |
or(x, y) |
x || y |
xor(x, y) |
!(!x && !y) && !(x && y) |
equals(x, y) |
x === y |
exists(x) |
!!x |
not(x) |
!x |
Ιδανικό για point-free pipelines και συναρτησιακή σύνθεση.
Σύνθεση (Composition)
compose(f, g) // x => f(g(x))
curry(f) // x => y => f(x, y)
flip(f) // f(x, y) --> f(y, x)
Λογική σύζευξη & διάζευξη
passAll(f, g) // x => f(x) && g(x)
passAny(f, g) // x => f(x) || g(x)
Σύγκλιση (Converge)
converge(and, [pluck('a'), pluck('b')])(x)
// → and(pluck(x, 'a'), pluck(x, 'b'))
See: converge
Πίνακες (Arrays)
Αναζήτηση & κατηγορήματα
find(list, x => x.y === 2)
findIndex(list, x => ...)
includes(list, 'item')
last(list)
find(list, hasProps('id'))
Ομαδοποίηση & ευρετηρίαση
groupBy(list, 'id')
indexBy(list, 'id')
Πραγματικά παραδείγματα
Σύνθεση κατηγορημάτων
isFloat = passAll(isNumber, compose(isInteger, not))
// n => isNumber(n) && not(isInteger(n))
function doStuff (object, options) { ... }
doStuffForce = curry(flip(doStuff))({ force: true })