Class: PreconditionStore
The store class which contains Pieces.
Hierarchy
-
Store
<Precondition
,"preconditions"
>↳
PreconditionStore
Constructors
constructor
• new PreconditionStore(): PreconditionStore
Returns
Overrides
Defined in
projects/framework/src/lib/structures/PreconditionStore.ts:11
Properties
#private
• Private
#private: any
Inherited from
Defined in
node_modules/@sapphire/pieces/dist/index.d.ts:413
Constructor
• Readonly
Constructor: AbstractConstructor
<Precondition
<PreconditionOptions
>>
Inherited from
Defined in
node_modules/@sapphire/pieces/dist/index.d.ts:414
[toStringTag]
• Readonly
[toStringTag]: string
Inherited from
Defined in
node_modules/typescript/lib/lib.es2015.symbol.wellknown.d.ts:137
constructor
• constructor: CollectionConstructor
Inherited from
Store.constructor
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:21
globalPreconditions
• Private
Readonly
globalPreconditions: Precondition
<PreconditionOptions
>[] = []
Defined in
projects/framework/src/lib/structures/PreconditionStore.ts:9
name
• Readonly
name: "preconditions"
Inherited from
Defined in
node_modules/@sapphire/pieces/dist/index.d.ts:415
paths
• Readonly
paths: Set
<string
>
Inherited from
Defined in
node_modules/@sapphire/pieces/dist/index.d.ts:416
size
• Readonly
size: number
Inherited from
Defined in
node_modules/typescript/lib/lib.es2015.collection.d.ts:45
strategy
• Readonly
strategy: ILoaderStrategy
<Precondition
<PreconditionOptions
>>
Inherited from
Defined in
node_modules/@sapphire/pieces/dist/index.d.ts:417
[species]
▪ Static
Readonly
[species]: MapConstructor
Inherited from
Defined in
node_modules/typescript/lib/lib.es2015.symbol.wellknown.d.ts:319
defaultStrategy
▪ Static
defaultStrategy: ILoaderStrategy
<any
>
The default strategy, defaults to LoaderStrategy, which is constructed on demand when a store is constructed, when none was set beforehand.
Inherited from
Defined in
node_modules/@sapphire/pieces/dist/index.d.ts:542
logger
▪ Static
logger: null
| StoreLogger
The default logger, defaults to null
.
Inherited from
Defined in
node_modules/@sapphire/pieces/dist/index.d.ts:546
Accessors
container
• get
container(): Container
A reference to the Container object for ease of use.
Returns
Container
See
container
Inherited from
Store.container
Defined in
node_modules/@sapphire/pieces/dist/index.d.ts:431
Methods
[iterator]
▸ [iterator](): IterableIterator
<[string
, Precondition
<PreconditionOptions
>]>
Returns an iterable of entries in the map.
Returns
IterableIterator
<[string
, Precondition
<PreconditionOptions
>]>
Inherited from
Defined in
node_modules/typescript/lib/lib.es2015.iterable.d.ts:119
at
▸ at(index
): undefined
| Precondition
<PreconditionOptions
>
Identical to Array.at(). Returns the item at a given index, allowing for positive and negative integers. Negative integers count back from the last item in the collection.
Parameters
Name | Type | Description |
---|---|---|
index | number | The index of the element to obtain |
Returns
undefined
| Precondition
<PreconditionOptions
>
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:98
chatInputRun
▸ chatInputRun(interaction
, command
, context?
): AsyncPreconditionResult
Parameters
Name | Type |
---|---|
interaction | ChatInputCommandInteraction <CacheType > |
command | ChatInputCommand |
context | PreconditionContext |
Returns
Defined in
projects/framework/src/lib/structures/PreconditionStore.ts:32
clear
▸ clear(): void
Returns
void
Overrides
Defined in
projects/framework/src/lib/structures/PreconditionStore.ts:95
clone
▸ clone(): Collection
<string
, Precondition
<PreconditionOptions
>>
Creates an identical shallow copy of this collection.
Returns
Collection
<string
, Precondition
<PreconditionOptions
>>
Example
const newColl = someColl.clone();
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:328
concat
▸ concat(...collections
): Collection
<string
, Precondition
<PreconditionOptions
>>
Combines this collection with others into a new collection. None of the source collections are modified.
Parameters
Name | Type | Description |
---|---|---|
...collections | ReadonlyCollection <string , Precondition <PreconditionOptions >>[] | Collections to merge |
Returns
Collection
<string
, Precondition
<PreconditionOptions
>>
Example
const newColl = someColl.concat(someOtherColl, anotherColl, ohBoyAColl);
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:338
construct
▸ construct(Ctor
, data
): Precondition
<PreconditionOptions
>
Constructs a Piece instance.
Parameters
Name | Type | Description |
---|---|---|
Ctor | ILoaderResultEntry <Precondition <PreconditionOptions >> | The Piece's constructor used to build the instance. |
data | HydratedModuleData | The module's information |
Returns
Precondition
<PreconditionOptions
>
An instance of the constructed piece.
Inherited from
Defined in
node_modules/@sapphire/pieces/dist/index.d.ts:518
contextMenuRun
▸ contextMenuRun(interaction
, command
, context?
): AsyncPreconditionResult
Parameters
Name | Type |
---|---|
interaction | ContextMenuCommandInteraction <CacheType > |
command | ContextMenuCommand |
context | PreconditionContext |
Returns
Defined in
projects/framework/src/lib/structures/PreconditionStore.ts:53
delete
▸ delete(key
): boolean
Parameters
Name | Type |
---|---|
key | string |
Returns
boolean
true if an element in the Map existed and has been removed, or false if the element does not exist.
Overrides
Defined in
projects/framework/src/lib/structures/PreconditionStore.ts:86
difference
▸ difference<T
>(other
): Collection
<string
, Precondition
<PreconditionOptions
> | T
>
The difference method returns a new structure containing items where the key is present in one of the original structures but not the other.
Type parameters
Name |
---|
T |
Parameters
Name | Type | Description |
---|---|---|
other | ReadonlyCollection <string , T > | The other Collection to filter against |
Returns
Collection
<string
, Precondition
<PreconditionOptions
> | T
>
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:378
each
▸ each(fn
): PreconditionStore
Identical to Map.forEach(), but returns the collection instead of undefined.
Parameters
Name | Type | Description |
---|---|---|
fn | (value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => void | Function to execute for each element |
Returns
Example
collection
.each(user => console.log(user.username))
.filter(user => user.bot)
.each(user => console.log(user.username));
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:303
▸ each<T
>(fn
, thisArg
): PreconditionStore
Type parameters
Name |
---|
T |
Parameters
Name | Type |
---|---|
fn | (this : T , value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => void |
thisArg | T |
Returns
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:304
ensure
▸ ensure(key
, defaultValueGenerator
): Precondition
<PreconditionOptions
>
Obtains the value of the given key if it exists, otherwise sets and returns the value provided by the default value generator.
Parameters
Name | Type | Description |
---|---|---|
key | string | The key to get if it exists, or set otherwise |
defaultValueGenerator | (key : string , collection : PreconditionStore ) => Precondition <PreconditionOptions > | A function that generates the default value |
Returns
Precondition
<PreconditionOptions
>
Example
collection.ensure(guildId, () => defaultGuildConfig);
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:41
entries
▸ entries(): IterableIterator
<[string
, Precondition
<PreconditionOptions
>]>
Returns an iterable of key, value pairs for every entry in the map.
Returns
IterableIterator
<[string
, Precondition
<PreconditionOptions
>]>
Inherited from
Defined in
node_modules/typescript/lib/lib.es2015.iterable.d.ts:124
equals
▸ equals(collection
): boolean
Checks if this collection shares identical items with another. This is different to checking for equality using equal-signs, because the collections may be different objects, but contain the same data.
Parameters
Name | Type | Description |
---|---|---|
collection | ReadonlyCollection <string , Precondition <PreconditionOptions >> | Collection to compare with |
Returns
boolean
Whether the collections have identical contents
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:347
every
▸ every<K2
>(fn
): this is Collection<K2, Precondition<PreconditionOptions>>
Checks if all items passes a test. Identical in behavior to Array.every().
Type parameters
Name | Type |
---|---|
K2 | extends string |
Parameters
Name | Type | Description |
---|---|---|
fn | (value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => key is K2 | Function used to test (should return a boolean) |
Returns
this is Collection<K2, Precondition<PreconditionOptions>>
Example
collection.every(user => !user.bot);
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:269
▸ every<V2
>(fn
): this is Collection<string, V2>
Type parameters
Name | Type |
---|---|
V2 | extends Precondition <PreconditionOptions > |
Parameters
Name | Type |
---|---|
fn | (value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => value is V2 |
Returns
this is Collection<string, V2>
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:270
▸ every(fn
): boolean
Parameters
Name | Type |
---|---|
fn | (value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => unknown |
Returns
boolean
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:271
▸ every<This
, K2
>(fn
, thisArg
): this is Collection<K2, Precondition<PreconditionOptions>>
Type parameters
Name | Type |
---|---|
This | This |
K2 | extends string |
Parameters
Name | Type |
---|---|
fn | (this : This , value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => key is K2 |
thisArg | This |
Returns
this is Collection<K2, Precondition<PreconditionOptions>>
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:272
▸ every<This
, V2
>(fn
, thisArg
): this is Collection<string, V2>
Type parameters
Name | Type |
---|---|
This | This |
V2 | extends Precondition <PreconditionOptions > |
Parameters
Name | Type |
---|---|
fn | (this : This , value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => value is V2 |
thisArg | This |
Returns
this is Collection<string, V2>
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:273
▸ every<This
>(fn
, thisArg
): boolean
Type parameters
Name |
---|
This |
Parameters
Name | Type |
---|---|
fn | (this : This , value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => unknown |
thisArg | This |
Returns
boolean
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:274
filter
▸ filter<K2
>(fn
): Collection
<K2
, Precondition
<PreconditionOptions
>>
Identical to Array.filter(), but returns a Collection instead of an Array.
Type parameters
Name | Type |
---|---|
K2 | extends string |
Parameters
Name | Type | Description |
---|---|---|
fn | (value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => key is K2 | The function to test with (should return boolean) |
Returns
Collection
<K2
, Precondition
<PreconditionOptions
>>
Example
collection.filter(user => user.username === 'Bob');
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:183
▸ filter<V2
>(fn
): Collection
<string
, V2
>
Type parameters
Name | Type |
---|---|
V2 | extends Precondition <PreconditionOptions > |
Parameters
Name | Type |
---|---|
fn | (value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => value is V2 |
Returns
Collection
<string
, V2
>
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:184
▸ filter(fn
): Collection
<string
, Precondition
<PreconditionOptions
>>
Parameters
Name | Type |
---|---|
fn | (value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => unknown |
Returns
Collection
<string
, Precondition
<PreconditionOptions
>>
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:185
▸ filter<This
, K2
>(fn
, thisArg
): Collection
<K2
, Precondition
<PreconditionOptions
>>
Type parameters
Name | Type |
---|---|
This | This |
K2 | extends string |
Parameters
Name | Type |
---|---|
fn | (this : This , value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => key is K2 |
thisArg | This |
Returns
Collection
<K2
, Precondition
<PreconditionOptions
>>
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:186
▸ filter<This
, V2
>(fn
, thisArg
): Collection
<string
, V2
>
Type parameters
Name | Type |
---|---|
This | This |
V2 | extends Precondition <PreconditionOptions > |
Parameters
Name | Type |
---|---|
fn | (this : This , value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => value is V2 |
thisArg | This |
Returns
Collection
<string
, V2
>
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:187
▸ filter<This
>(fn
, thisArg
): Collection
<string
, Precondition
<PreconditionOptions
>>
Type parameters
Name |
---|
This |
Parameters
Name | Type |
---|---|
fn | (this : This , value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => unknown |
thisArg | This |
Returns
Collection
<string
, Precondition
<PreconditionOptions
>>
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:188
find
▸ find<V2
>(fn
): undefined
| V2
Searches for a single item where the given function returns a truthy value. This behaves like
Array.find().
All collections used in Discord.js are mapped using their id
property, and if you want to find by id you
should use the get
method. See
MDN for details.
Type parameters
Name | Type |
---|---|
V2 | extends Precondition <PreconditionOptions > |
Parameters
Name | Type | Description |
---|---|---|
fn | (value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => value is V2 | The function to test with (should return boolean) |
Returns
undefined
| V2
Example
collection.find(user => user.username === 'Bob');
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:142
▸ find(fn
): undefined
| Precondition
<PreconditionOptions
>
Parameters
Name | Type |
---|---|
fn | (value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => unknown |
Returns
undefined
| Precondition
<PreconditionOptions
>
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:143
▸ find<This
, V2
>(fn
, thisArg
): undefined
| V2
Type parameters
Name | Type |
---|---|
This | This |
V2 | extends Precondition <PreconditionOptions > |
Parameters
Name | Type |
---|---|
fn | (this : This , value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => value is V2 |
thisArg | This |
Returns
undefined
| V2
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:144
▸ find<This
>(fn
, thisArg
): undefined
| Precondition
<PreconditionOptions
>
Type parameters
Name |
---|
This |
Parameters
Name | Type |
---|---|
fn | (this : This , value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => unknown |
thisArg | This |
Returns
undefined
| Precondition
<PreconditionOptions
>
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:145
findKey
▸ findKey<K2
>(fn
): undefined
| K2
Searches for the key of a single item where the given function returns a truthy value. This behaves like Array.findIndex(), but returns the key rather than the positional index.
Type parameters
Name | Type |
---|---|
K2 | extends string |
Parameters
Name | Type | Description |
---|---|---|
fn | (value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => key is K2 | The function to test with (should return boolean) |
Returns
undefined
| K2
Example
collection.findKey(user => user.username === 'Bob');
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:158
▸ findKey(fn
): undefined
| string
Parameters
Name | Type |
---|---|
fn | (value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => unknown |
Returns
undefined
| string
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:159
▸ findKey<This
, K2
>(fn
, thisArg
): undefined
| K2
Type parameters
Name | Type |
---|---|
This | This |
K2 | extends string |
Parameters
Name | Type |
---|---|
fn | (this : This , value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => key is K2 |
thisArg | This |
Returns
undefined
| K2
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:160
▸ findKey<This
>(fn
, thisArg
): undefined
| string
Type parameters
Name |
---|
This |
Parameters
Name | Type |
---|---|
fn | (this : This , value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => unknown |
thisArg | This |
Returns
undefined
| string
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:161
first
▸ first(): undefined
| Precondition
<PreconditionOptions
>
Obtains the first value(s) in this collection.
Returns
undefined
| Precondition
<PreconditionOptions
>
A single value if no amount is provided or an array of values, starting from the end if amount is negative
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:62
▸ first(amount
): Precondition
<PreconditionOptions
>[]
Parameters
Name | Type |
---|---|
amount | number |
Returns
Precondition
<PreconditionOptions
>[]
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:63
firstKey
▸ firstKey(): undefined
| string
Obtains the first key(s) in this collection.
Returns
undefined
| string
A single key if no amount is provided or an array of keys, starting from the end if amount is negative
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:71
▸ firstKey(amount
): string
[]
Parameters
Name | Type |
---|---|
amount | number |
Returns
string
[]
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:72
flatMap
▸ flatMap<T
>(fn
): Collection
<string
, T
>
Maps each item into a Collection, then joins the results into a single Collection. Identical in behavior to Array.flatMap().
Type parameters
Name |
---|
T |
Parameters
Name | Type | Description |
---|---|---|
fn | (value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => Collection <string , T > | Function that produces a new Collection |
Returns
Collection
<string
, T
>
Example
collection.flatMap(guild => guild.members.cache);
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:217
▸ flatMap<T
, This
>(fn
, thisArg
): Collection
<string
, T
>
Type parameters
Name |
---|
T |
This |
Parameters
Name | Type |
---|---|
fn | (this : This , value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => Collection <string , T > |
thisArg | This |
Returns
Collection
<string
, T
>
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:218
forEach
▸ forEach(callbackfn
, thisArg?
): void
Executes a provided function once per each key/value pair in the Map, in insertion order.
Parameters
Name | Type |
---|---|
callbackfn | (value : Precondition <PreconditionOptions >, key : string , map : Map <string , Precondition <PreconditionOptions >>) => void |
thisArg? | any |
Returns
void
Inherited from
Defined in
node_modules/typescript/lib/lib.es2015.collection.d.ts:28
get
▸ get(key
): undefined
| Precondition
<PreconditionOptions
>
Returns a specified element from the Map object. If the value that is associated to the provided key is an object, then you will get a reference to that object and any change made to that object will effectively modify it inside the Map.
Parameters
Name | Type |
---|---|
key | string |
Returns
undefined
| Precondition
<PreconditionOptions
>
Returns the element associated with the specified key. If no element is associated with the specified key, undefined is returned.
Inherited from
Defined in
node_modules/typescript/lib/lib.es2015.collection.d.ts:33
has
▸ has(key
): boolean
Parameters
Name | Type |
---|---|
key | string |
Returns
boolean
boolean indicating whether an element with the specified key exists or not.
Inherited from
Defined in
node_modules/typescript/lib/lib.es2015.collection.d.ts:37
hasAll
▸ hasAll(...keys
): boolean
Checks if all of the elements exist in the collection.
Parameters
Name | Type | Description |
---|---|---|
...keys | string [] | The keys of the elements to check for |
Returns
boolean
true
if all of the elements exist, false
if at least one does not exist.
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:48
hasAny
▸ hasAny(...keys
): boolean
Checks if any of the elements exist in the collection.
Parameters
Name | Type | Description |
---|---|---|
...keys | string [] | The keys of the elements to check for |
Returns
boolean
true
if any of the elements exist, false
if none exist.
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:55
insert
▸ insert(piece
): Promise
<Precondition
<PreconditionOptions
>>
Inserts a piece into the store.
Parameters
Name | Type | Description |
---|---|---|
piece | Precondition <PreconditionOptions > | The piece to be inserted into the store. |
Returns
Promise
<Precondition
<PreconditionOptions
>>
The inserted piece.
Inherited from
Defined in
node_modules/@sapphire/pieces/dist/index.d.ts:511
intersect
▸ intersect<T
>(other
): Collection
<string
, T
>
The intersect method returns a new structure containing items where the keys and values are present in both original structures.
Type parameters
Name |
---|
T |
Parameters
Name | Type | Description |
---|---|---|
other | ReadonlyCollection <string , T > | The other Collection to filter against |
Returns
Collection
<string
, T
>
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:366
keyAt
▸ keyAt(index
): undefined
| string
Identical to Array.at(). Returns the key at a given index, allowing for positive and negative integers. Negative integers count back from the last item in the collection.
Parameters
Name | Type | Description |
---|---|---|
index | number | The index of the key to obtain |
Returns
undefined
| string
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:106
keys
▸ keys(): IterableIterator
<string
>
Returns an iterable of keys in the map
Returns
IterableIterator
<string
>
Inherited from
Defined in
node_modules/typescript/lib/lib.es2015.iterable.d.ts:129
last
▸ last(): undefined
| Precondition
<PreconditionOptions
>
Obtains the last value(s) in this collection.
Returns
undefined
| Precondition
<PreconditionOptions
>
A single value if no amount is provided or an array of values, starting from the start if amount is negative
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:80
▸ last(amount
): Precondition
<PreconditionOptions
>[]
Parameters
Name | Type |
---|---|
amount | number |
Returns
Precondition
<PreconditionOptions
>[]
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:81
lastKey
▸ lastKey(): undefined
| string
Obtains the last key(s) in this collection.
Returns
undefined
| string
A single key if no amount is provided or an array of keys, starting from the start if amount is negative
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:89
▸ lastKey(amount
): string
[]
Parameters
Name | Type |
---|---|
amount | number |
Returns
string
[]
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:90
load
▸ load(root
, path
): Promise
<Precondition
<PreconditionOptions
>[]>
Loads one or more pieces from a path.
Parameters
Name | Type | Description |
---|---|---|
root | string | The root directory the file is from. |
path | string | The path of the file to load, relative to the root . |
Returns
Promise
<Precondition
<PreconditionOptions
>[]>
All the loaded pieces.
Inherited from
Defined in
node_modules/@sapphire/pieces/dist/index.d.ts:485
loadAll
▸ loadAll(): Promise
<void
>
Loads all pieces from all directories specified by paths.
Returns
Promise
<void
>
Inherited from
Defined in
node_modules/@sapphire/pieces/dist/index.d.ts:499
loadPiece
▸ loadPiece(entry
): Promise
<void
>
Adds a piece into the store's list of manually registered pieces. If ()
was called, the
piece will be loaded immediately, otherwise it will be queued until ()
is called.
All manually registered pieces will be kept even after they are loaded to ensure they can be loaded again if
()
is called again.
Parameters
Name | Type | Description |
---|---|---|
entry | StoreManuallyRegisteredPiece <"preconditions" > | The entry to load. |
Returns
Promise
<void
>
Remarks
- Pieces loaded this way will have their
root
andpath
set to VirtualPath, and as such, cannot be reloaded. - This method is useful in environments where file system access is limited or unavailable, such as when using Serverless Computing.
- This method will always throw a TypeError if
entry.piece
is not a class. - This method will always throw a
LoaderError
if the piece does not extend thestore's piece constructor
. - This operation is atomic, if any of the above errors are thrown, the piece will not be loaded.
Seealso
Since
3.8.0
Example
import { container } from '@sapphire/pieces';
class PingCommand extends Command {
// ...
}
container.stores.get('commands').loadPiece({
name: 'ping',
piece: PingCommand
});
Inherited from
Defined in
node_modules/@sapphire/pieces/dist/index.d.ts:478
map
▸ map<T
>(fn
): T
[]
Maps each item to another value into an array. Identical in behavior to Array.map().
Type parameters
Name |
---|
T |
Parameters
Name | Type | Description |
---|---|---|
fn | (value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => T | Function that produces an element of the new array, taking three arguments |
Returns
T
[]
Example
collection.map(user => user.tag);
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:230
▸ map<This
, T
>(fn
, thisArg
): T
[]
Type parameters
Name |
---|
This |
T |
Parameters
Name | Type |
---|---|
fn | (this : This , value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => T |
thisArg | This |
Returns
T
[]
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:231
mapValues
▸ mapValues<T
>(fn
): Collection
<string
, T
>
Maps each item to another value into a collection. Identical in behavior to Array.map().
Type parameters
Name |
---|
T |
Parameters
Name | Type | Description |
---|---|---|
fn | (value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => T | Function that produces an element of the new collection, taking three arguments |
Returns
Collection
<string
, T
>
Example
collection.mapValues(user => user.tag);
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:243
▸ mapValues<This
, T
>(fn
, thisArg
): Collection
<string
, T
>
Type parameters
Name |
---|
This |
T |
Parameters
Name | Type |
---|---|
fn | (this : This , value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => T |
thisArg | This |
Returns
Collection
<string
, T
>
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:244
merge
▸ merge<T
, R
>(other
, whenInSelf
, whenInOther
, whenInBoth
): Collection
<string
, R
>
Merges two Collections together into a new Collection.
Type parameters
Name |
---|
T |
R |
Parameters
Name | Type | Description |
---|---|---|
other | ReadonlyCollection <string , T > | The other Collection to merge with |
whenInSelf | (value : Precondition <PreconditionOptions >, key : string ) => Keep <R > | Function getting the result if the entry only exists in this Collection |
whenInOther | (valueOther : T , key : string ) => Keep <R > | Function getting the result if the entry only exists in the other Collection |
whenInBoth | (value : Precondition <PreconditionOptions >, valueOther : T , key : string ) => Keep <R > | Function getting the result if the entry exists in both Collections |
Returns
Collection
<string
, R
>
Example
// Sums up the entries in two collections.
coll.merge(
other,
x => ({ keep: true, value: x }),
y => ({ keep: true, value: y }),
(x, y) => ({ keep: true, value: x + y }),
);
Example
// Intersects two collections in a left-biased manner.
coll.merge(
other,
x => ({ keep: false }),
y => ({ keep: false }),
(x, _) => ({ keep: true, value: x }),
);
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:407
messageRun
▸ messageRun(message
, command
, context?
): AsyncPreconditionResult
Parameters
Name | Type |
---|---|
message | Message <boolean > |
command | MessageCommand |
context | PreconditionContext |
Returns
Defined in
projects/framework/src/lib/structures/PreconditionStore.ts:15
partition
▸ partition<K2
>(fn
): [Collection
<K2
, Precondition
<PreconditionOptions
>>, Collection
<Exclude
<string
, K2
>, Precondition
<PreconditionOptions
>>]
Partitions the collection into two collections where the first collection contains the items that passed and the second contains the items that failed.
Type parameters
Name | Type |
---|---|
K2 | extends string |
Parameters
Name | Type | Description |
---|---|---|
fn | (value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => key is K2 | Function used to test (should return a boolean) |
Returns
[Collection
<K2
, Precondition
<PreconditionOptions
>>, Collection
<Exclude
<string
, K2
>, Precondition
<PreconditionOptions
>>]
Example
const [big, small] = collection.partition(guild => guild.memberCount > 250);
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:200
▸ partition<V2
>(fn
): [Collection
<string
, V2
>, Collection
<string
, Exclude
<Precondition
<PreconditionOptions
>, V2
>>]
Type parameters
Name | Type |
---|---|
V2 | extends Precondition <PreconditionOptions > |
Parameters
Name | Type |
---|---|
fn | (value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => value is V2 |
Returns
[Collection
<string
, V2
>, Collection
<string
, Exclude
<Precondition
<PreconditionOptions
>, V2
>>]
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:201
▸ partition(fn
): [Collection
<string
, Precondition
<PreconditionOptions
>>, Collection
<string
, Precondition
<PreconditionOptions
>>]
Parameters
Name | Type |
---|---|
fn | (value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => unknown |
Returns
[Collection
<string
, Precondition
<PreconditionOptions
>>, Collection
<string
, Precondition
<PreconditionOptions
>>]
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:202
▸ partition<This
, K2
>(fn
, thisArg
): [Collection
<K2
, Precondition
<PreconditionOptions
>>, Collection
<Exclude
<string
, K2
>, Precondition
<PreconditionOptions
>>]
Type parameters
Name | Type |
---|---|
This | This |
K2 | extends string |
Parameters
Name | Type |
---|---|
fn | (this : This , value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => key is K2 |
thisArg | This |
Returns
[Collection
<K2
, Precondition
<PreconditionOptions
>>, Collection
<Exclude
<string
, K2
>, Precondition
<PreconditionOptions
>>]
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:203
▸ partition<This
, V2
>(fn
, thisArg
): [Collection
<string
, V2
>, Collection
<string
, Exclude
<Precondition
<PreconditionOptions
>, V2
>>]
Type parameters
Name | Type |
---|---|
This | This |
V2 | extends Precondition <PreconditionOptions > |
Parameters
Name | Type |
---|---|
fn | (this : This , value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => value is V2 |
thisArg | This |
Returns
[Collection
<string
, V2
>, Collection
<string
, Exclude
<Precondition
<PreconditionOptions
>, V2
>>]
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:204
▸ partition<This
>(fn
, thisArg
): [Collection
<string
, Precondition
<PreconditionOptions
>>, Collection
<string
, Precondition
<PreconditionOptions
>>]
Type parameters
Name |
---|
This |
Parameters
Name | Type |
---|---|
fn | (this : This , value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => unknown |
thisArg | This |
Returns
[Collection
<string
, Precondition
<PreconditionOptions
>>, Collection
<string
, Precondition
<PreconditionOptions
>>]
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:205
random
▸ random(): undefined
| Precondition
<PreconditionOptions
>
Obtains unique random value(s) from this collection.
Returns
undefined
| Precondition
<PreconditionOptions
>
A single value if no amount is provided or an array of values
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:113
▸ random(amount
): Precondition
<PreconditionOptions
>[]
Parameters
Name | Type |
---|---|
amount | number |
Returns
Precondition
<PreconditionOptions
>[]
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:114
randomKey
▸ randomKey(): undefined
| string
Obtains unique random key(s) from this collection.
Returns
undefined
| string
A single key if no amount is provided or an array
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:121
▸ randomKey(amount
): string
[]
Parameters
Name | Type |
---|---|
amount | number |
Returns
string
[]
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:122
reduce
▸ reduce<T
>(fn
, initialValue?
): T
Applies a function to produce a single value. Identical in behavior to Array.reduce().
Type parameters
Name | Type |
---|---|
T | Precondition <PreconditionOptions > |
Parameters
Name | Type | Description |
---|---|---|
fn | (accumulator : T , value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => T | Function used to reduce, taking four arguments; accumulator , currentValue , currentKey , and collection |
initialValue? | T | Starting value for the accumulator |
Returns
T
Example
collection.reduce((acc, guild) => acc + guild.memberCount, 0);
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:287
registerPath
▸ registerPath(path
): PreconditionStore
Registers a directory into the store.
Parameters
Name | Type | Description |
---|---|---|
path | Path | The path to be added. |
Returns
Example
store
.registerPath(resolve('commands'))
.registerPath(resolve('third-party', 'commands'));
Inherited from
Defined in
node_modules/@sapphire/pieces/dist/index.d.ts:442
resolve
▸ resolve(name
): Precondition
<PreconditionOptions
>
Resolves a piece by its name or its instance.
Parameters
Name | Type | Description |
---|---|---|
name | string | Precondition <PreconditionOptions > | The name of the piece or the instance itself. |
Returns
Precondition
<PreconditionOptions
>
The resolved piece.
Inherited from
Defined in
node_modules/@sapphire/pieces/dist/index.d.ts:505
reverse
▸ reverse(): PreconditionStore
Identical to Array.reverse() but returns a Collection instead of an Array.
Returns
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:127
set
▸ set(key
, value
): PreconditionStore
Adds a new element with a specified key and value to the Map. If an element with the same key already exists, the element will be updated.
Parameters
Name | Type |
---|---|
key | string |
value | Precondition <PreconditionOptions > |
Returns
Overrides
Defined in
projects/framework/src/lib/structures/PreconditionStore.ts:74
some
▸ some(fn
): boolean
Checks if there exists an item that passes a test. Identical in behavior to Array.some().
Parameters
Name | Type | Description |
---|---|---|
fn | (value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => unknown | Function used to test (should return a boolean) |
Returns
boolean
Example
collection.some(user => user.discriminator === '0000');
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:256
▸ some<T
>(fn
, thisArg
): boolean
Type parameters
Name |
---|
T |
Parameters
Name | Type |
---|---|
fn | (this : T , value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => unknown |
thisArg | T |
Returns
boolean
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:257
sort
▸ sort(compareFunction?
): PreconditionStore
The sort method sorts the items of a collection in place and returns it. The sort is not necessarily stable in Node 10 or older. The default sort order is according to string Unicode code points.
Parameters
Name | Type | Description |
---|---|---|
compareFunction? | Comparator <string , Precondition <PreconditionOptions >> | Specifies a function that defines the sort order. If omitted, the collection is sorted according to each character's Unicode code point value, according to the string conversion of each element. |
Returns
Example
collection.sort((userA, userB) => userA.createdTimestamp - userB.createdTimestamp);
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:360
sorted
▸ sorted(compareFunction?
): Collection
<string
, Precondition
<PreconditionOptions
>>
The sorted method sorts the items of a collection and returns it. The sort is not necessarily stable in Node 10 or older. The default sort order is according to string Unicode code points.
Parameters
Name | Type | Description |
---|---|---|
compareFunction? | Comparator <string , Precondition <PreconditionOptions >> | Specifies a function that defines the sort order. If omitted, the collection is sorted according to each character's Unicode code point value, according to the string conversion of each element. |
Returns
Collection
<string
, Precondition
<PreconditionOptions
>>
Example
collection.sorted((userA, userB) => userA.createdTimestamp - userB.createdTimestamp);
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:421
subtract
▸ subtract<T
>(other
): Collection
<string
, Precondition
<PreconditionOptions
>>
The subtract method returns a new structure containing items where the keys and values of the original structure are not present in the other.
Type parameters
Name |
---|
T |
Parameters
Name | Type | Description |
---|---|---|
other | ReadonlyCollection <string , T > | The other Collection to filter against |
Returns
Collection
<string
, Precondition
<PreconditionOptions
>>
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:372
sweep
▸ sweep(fn
): number
Removes items that satisfy the provided filter function.
Parameters
Name | Type | Description |
---|---|---|
fn | (value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => unknown | Function used to test (should return a boolean) |
Returns
number
The number of removed entries
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:169
▸ sweep<T
>(fn
, thisArg
): number
Type parameters
Name |
---|
T |
Parameters
Name | Type |
---|---|
fn | (this : T , value : Precondition <PreconditionOptions >, key : string , collection : PreconditionStore ) => unknown |
thisArg | T |
Returns
number
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:170
tap
▸ tap(fn
): PreconditionStore
Runs a function on the collection and returns the collection.
Parameters
Name | Type | Description |
---|---|---|
fn | (collection : PreconditionStore ) => void | Function to execute |
Returns
Example
collection
.tap(coll => console.log(coll.size))
.filter(user => user.bot)
.tap(coll => console.log(coll.size))
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:318
▸ tap<T
>(fn
, thisArg
): PreconditionStore
Type parameters
Name |
---|
T |
Parameters
Name | Type |
---|---|
fn | (this : T , collection : PreconditionStore ) => void |
thisArg | T |
Returns
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:319
toJSON
▸ toJSON(): Precondition
<PreconditionOptions
>[]
Returns
Precondition
<PreconditionOptions
>[]
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:422
unload
▸ unload(name
): Promise
<Precondition
<PreconditionOptions
>>
Unloads a piece given its instance or its name.
Parameters
Name | Type | Description |
---|---|---|
name | string | Precondition <PreconditionOptions > | The name of the file to load. |
Returns
Promise
<Precondition
<PreconditionOptions
>>
Returns the piece that was unloaded.
Inherited from
Defined in
node_modules/@sapphire/pieces/dist/index.d.ts:491
unloadAll
▸ unloadAll(): Promise
<Precondition
<PreconditionOptions
>[]>
Unloads all pieces from the store.
Returns
Promise
<Precondition
<PreconditionOptions
>[]>
Inherited from
Defined in
node_modules/@sapphire/pieces/dist/index.d.ts:495
values
▸ values(): IterableIterator
<Precondition
<PreconditionOptions
>>
Returns an iterable of values in the map
Returns
IterableIterator
<Precondition
<PreconditionOptions
>>
Inherited from
Defined in
node_modules/typescript/lib/lib.es2015.iterable.d.ts:134
combineEntries
▸ combineEntries<K
, V
>(entries
, combine
): Collection
<K
, V
>
Creates a Collection from a list of entries.
Type parameters
Name |
---|
K |
V |
Parameters
Name | Type | Description |
---|---|---|
entries | Iterable <[K , V ]> | The list of entries |
combine | (firstValue : V , secondValue : V , key : K ) => V | Function to combine an existing entry with a new one |
Returns
Collection
<K
, V
>
Example
Collection.combineEntries([["a", 1], ["b", 2], ["a", 2]], (x, y) => x + y);
// returns Collection { "a" => 3, "b" => 2 }
Inherited from
Defined in
node_modules/@discordjs/collection/dist/index.d.ts:435