Discord bots. Simplified and boosted · Docs · Contribute
A utility data structure used within the Discordoo, Discord API library.
Collection was created for use inside Discordoo, for storing the cache in it and for convenient interaction with local lists.
We decided to put the Collection in a separate repository, so that third-party developers can use it without installing the entire Discordoo.
- Collection API Documentation
- Optionally lodash can be installed for deep equal processing
- Node.js 12.0.0 or newer required
import { Collection } from '@discordoo/collection'
const collection = new Collection()
collection.set(1, 2).set(2, 3).set(3, 4).set(4, 5).set(5, 6)
// filter out elements that does not match filter fn
const filtered = collection.filter((value, key, collection) => key % 2 !== 0) // returns array
// do something with filtered elements
console.log(filtered.length) // 3
filtered.forEach(v => console.log(v[0])) // log all keys of filtered elements
filtered.forEach(v => console.log(v[1])) // log all values of filtered elements
/**
* Filtered elements array looks like this:
* [ [ FilteredKey, FilteredValue ], [ FilteredKey, FilteredValue ], [ FilteredKey, FilteredValue ] ]
* which means that this
* Collection [Map] {
* 1 => 2,
* 2 => 3,
* 3 => 4,
* 4 => 5,
* 5 => 6
* }
* after this
* collection.filter((value, key, collection) => key % 2 !== 0)
* turns into this
* [ [ 1, 2 ], [ 3, 4 ], [ 5, 6 ] ]
* */
const fn = (value, key, collection) => key % 2 !== 0
// also you can choose in wich format return filtered values
collection.filter(fn, { returnType: 'map' }) // return data stored in javascript Map
collection.filter(fn, { returnType: 'collection' }) // return data stored in collection
collection.filter(fn, { returnType: 'array' }) // return data stored in array (default)import { Collection } from '@discordoo/collection'
const collection = new Collection(), fn = () => {}
console.log(collection.filter<Collection> (fn, { returnType: 'collection' }).size)
console.log(collection.filter<Map<any, any>>(fn, { returnType: 'map' }) .size)
console.log(collection.filter<Array<any>> (fn, { returnType: 'array' }) .length)
console.log(collection.filter(fn).length) // default to Array<[ K, V ]>import { Collection } from '@discordoo/collection'
const collection = new Collection()
collection.random() // get 1 random value from collection
const values = collection.random(32) // get 32 random values from collection
console.log(values) // [ value, value, value ]
// get random keys from collection
collection.random(11, { returnType: 'keys' })
// get random key from collection
collection.random(undefined /* or 1 */, { returnType: 'keys' })import { Collection } from '@discordoo/collection'
type K = number
type V = string
const collection = new Collection<K, V>() // number - key, string - value
collection.random<K[]>(5, { returnType: 'keys' }) // tell typescript that we are expect array of collection keys
collection.random<[ K, V ]>(undefined, { returnType: 'blocks' }) // tell typescript that we are expect 1 block
collection.random<Array<[ K, V ]>>(5, { returnType: 'blocks' }) // tell typescript that we are expect array of blocksDiscord.js is the most popular library for developing bots, so we will compare with it. (if you're interested, ddoo is roughly comparable to eris in collection speed)
Higher is better.
- 100 elements in collection, 5 random elements | result
- 800 elements in collection, 150 random elements | result
- 10000 elements in collection, 1000 random elements | result
- 10000 elements in collection, 8000 random elements | result
