Nomchy/discord.js
1
0
Fork 0
mirror of https://github.com/discordjs/discord.js.git synced 2026-03-18 20:43:30 +01:00
Code Issues Packages Projects Releases Wiki Activity

Make JSDocs follow general conventions (#582)

Browse Source 
* Make JSDocs follow usual conventions

* Fix StringResolvable name

* Make function lowercase
This commit is contained in:
Schuyler Cebulskie
2016-09-03 04:57:25 -04:00
committed by Amish Shah
parent 44efcf3f52
commit 27652b94af
33 changed files with 262 additions and 262 deletions
Download Patch File Download Diff File Expand all files Collapse all files

26
src/client/Client.js
View File

@@ -67,22 +67,22 @@ class Client extends EventEmitter {
this.voice = new ClientVoiceManager(this); this.voice = new ClientVoiceManager(this);
/** /**
* A Collection of the Client's stored users * A Collection of the Client's stored users
* @type {Collection<String, User>} * @type {Collection<string, User>}
*/ */
this.users = new Collection(); this.users = new Collection();
/** /**
* A Collection of the Client's stored guilds * A Collection of the Client's stored guilds
* @type {Collection<String, Guild>} * @type {Collection<string, Guild>}
*/ */
this.guilds = new Collection(); this.guilds = new Collection();
/** /**
* A Collection of the Client's stored channels * A Collection of the Client's stored channels
* @type {Collection<String, Channel>} * @type {Collection<string, Channel>}
*/ */
this.channels = new Collection(); this.channels = new Collection();
/** /**
* The authorization token for the logged in user/bot. * The authorization token for the logged in user/bot.
* @type {?String} * @type {?string}
*/ */
this.token = null; this.token = null;
/** /**
@@ -92,17 +92,17 @@ class Client extends EventEmitter {
this.user = null; this.user = null;
/** /**
* The email, if there is one, for the logged in Client * The email, if there is one, for the logged in Client
* @type {?String} * @type {?string}
*/ */
this.email = null; this.email = null;
/** /**
* The password, if there is one, for the logged in Client * The password, if there is one, for the logged in Client
* @type {?String} * @type {?string}
*/ */
this.password = null; this.password = null;
/** /**
* The time in milliseconds the Client connected * The time in milliseconds the Client connected
* @type {?Number} * @type {?number}
*/ */
this.readyTime = null; this.readyTime = null;
this._intervals = []; this._intervals = [];
@@ -114,10 +114,10 @@ class Client extends EventEmitter {
* much better to use a bot account rather than a user account. * much better to use a bot account rather than a user account.
* Bot accounts have higher rate limits and have access to some features user accounts don't have. User bots * Bot accounts have higher rate limits and have access to some features user accounts don't have. User bots
* that are making a lot of API requests can even be banned.</warn> * that are making a lot of API requests can even be banned.</warn>
* @param {String} emailOrToken The email or token used for the account. If it is an email, a password _must_ be * @param {string} emailOrToken The email or token used for the account. If it is an email, a password _must_ be
* provided. * provided.
* @param {String} [password] The password for the account, only needed if an email was provided. * @param {string} [password] The password for the account, only needed if an email was provided.
* @return {Promise<String>} * @return {Promise<string>}
* @example * @example
* // log the client in using a token * // log the client in using a token
* const token = 'my token'; * const token = 'my token';
@@ -176,7 +176,7 @@ class Client extends EventEmitter {
/** /**
* Caches a user, or obtains it from the cache if it's already cached. * Caches a user, or obtains it from the cache if it's already cached.
* If the user isn't already cached, it will only be obtainable by OAuth bot accounts. * If the user isn't already cached, it will only be obtainable by OAuth bot accounts.
* @param {String} id The ID of the user to obtain * @param {string} id The ID of the user to obtain
* @return {Promise<User>} * @return {Promise<User>}
*/ */
fetchUser(id) { fetchUser(id) {
@@ -187,7 +187,7 @@ class Client extends EventEmitter {
/** /**
* Returns a Collection, mapping Guild ID to Voice Connections. * Returns a Collection, mapping Guild ID to Voice Connections.
* @readonly * @readonly
* @type {Collection<String, VoiceConnection>} * @type {Collection<string, VoiceConnection>}
*/ */
get voiceConnections() { get voiceConnections() {
return this.voice.connections; return this.voice.connections;
@@ -196,7 +196,7 @@ class Client extends EventEmitter {
/** /**
* The uptime for the logged in Client. * The uptime for the logged in Client.
* @readonly * @readonly
* @type {?Number} * @type {?number}
*/ */
get uptime() { get uptime() {
return this.readyTime ? Date.now() - this.readyTime : null; return this.readyTime ? Date.now() - this.readyTime : null;

16
src/client/ClientDataResolver.js
View File

@@ -106,13 +106,13 @@ class ClientDataResolver {
* Data that resolves to give a Base64 string, typically for image uploading. This can be: * Data that resolves to give a Base64 string, typically for image uploading. This can be:
* * A Buffer * * A Buffer
* * A Base64 String * * A Base64 String
* @typedef {Buffer|String} Base64Resolvable * @typedef {Buffer|string} Base64Resolvable
*/ */
/** /**
* Resolves a Base64Resolvable to a Base 64 image * Resolves a Base64Resolvable to a Base 64 image
* @param {Base64Resolvable} dataResolvable the base 64 resolvable you want to resolve * @param {Base64Resolvable} dataResolvable the base 64 resolvable you want to resolve
* @returns {?String} * @returns {?string}
*/ */
resolveBase64(data) { resolveBase64(data) {
if (data instanceof Buffer) { if (data instanceof Buffer) {
@@ -126,7 +126,7 @@ class ClientDataResolver {
* Data that can be resolved to give a Channel. This can be: * Data that can be resolved to give a Channel. This can be:
* * An instance of a Channel * * An instance of a Channel
* * An ID of a Channel * * An ID of a Channel
* @typedef {Channel|String} ChannelResolvable * @typedef {Channel|string} ChannelResolvable
*/ */
/** /**
@@ -151,13 +151,13 @@ class ClientDataResolver {
* * A String * * A String
* * An Array (joined with a new line delimiter to give a string) * * An Array (joined with a new line delimiter to give a string)
* * Any object * * Any object
* @typedef {String|Array|Object} StringResolvable * @typedef {string|Array|Object} StringResolvable
*/ */
/** /**
* Resolves a StringResolvable to a String * Resolves a StringResolvable to a String
* @param {StringResolvable} stringResolvable the string resolvable to resolve * @param {StringResolvable} StringResolvable the string resolvable to resolve
* @returns {String} * @returns {string}
*/ */
resolveString(data) { resolveString(data) {
if (data instanceof String) { if (data instanceof String) {
@@ -176,13 +176,13 @@ class ClientDataResolver {
* * A Buffer * * A Buffer
* * The path to a local file * * The path to a local file
* * An URL * * An URL
* @typedef {String|Buffer} FileResolvable * @typedef {string|Buffer} FileResolvable
*/ */
/** /**
* Resolves a FileResolvable to a Buffer * Resolves a FileResolvable to a Buffer
* @param {FileResolvable} fileResolvable the file resolvable to resolve * @param {FileResolvable} fileResolvable the file resolvable to resolve
* @returns {String|Buffer} * @returns {string|Buffer}
*/ */
resolveFile(resource) { resolveFile(resource) {
if ($string(resource)) { if ($string(resource)) {

14
src/client/ClientManager.js
View File

@@ -14,17 +14,17 @@ class ClientManager {
this.client = client; this.client = client;
/** /**
* The heartbeat interval, null if not yet set * The heartbeat interval, null if not yet set
* @type {?Number} * @type {?number}
*/ */
this.heartbeatInterval = null; this.heartbeatInterval = null;
} }
/** /**
* Connects the Client to the WebSocket * Connects the Client to the WebSocket
* @param {String} token the authorization token * @param {string} token the authorization token
* @param {Function} resolve function to run when connection is successful * @param {function} resolve function to run when connection is successful
* @param {Function} reject function to run when connection fails * @param {function} reject function to run when connection fails
* @returns {null} * @returns {void}
*/ */
connectToWebSocket(token, resolve, reject) { connectToWebSocket(token, resolve, reject) {
this.client.token = token; this.client.token = token;
@@ -40,8 +40,8 @@ class ClientManager {
/** /**
* Sets up a keep-alive interval to keep the Client's connection valid * Sets up a keep-alive interval to keep the Client's connection valid
* @param {Number} time the interval in milliseconds at which heartbeat packets should be sent * @param {number} time the interval in milliseconds at which heartbeat packets should be sent
* @returns {null} * @returns {void}
*/ */
setupKeepAlive(time) { setupKeepAlive(time) {
this.heartbeatInterval = this.client.setInterval(() => { this.heartbeatInterval = this.client.setInterval(() => {

2
src/client/rest/RequestHandlers/RequestHandler.js
View File

@@ -19,7 +19,7 @@ class RequestHandler {
/** /**
* Whether or not the client is being rate limited on every endpoint. * Whether or not the client is being rate limited on every endpoint.
* @type {Boolean} * @type {boolean}
*/ */
get globalLimit() { get globalLimit() {
return this.restManager.globallyRateLimited; return this.restManager.globallyRateLimited;

6
src/client/rest/RequestHandlers/Sequential.js
View File

@@ -14,20 +14,20 @@ class SequentialRequestHandler extends RequestHandler {
/** /**
* Whether this rate limiter is waiting for a response from a request * Whether this rate limiter is waiting for a response from a request
* @type {Boolean} * @type {boolean}
*/ */
this.waiting = false; this.waiting = false;
/** /**
* The endpoint that this handler is handling * The endpoint that this handler is handling
* @type {String} * @type {string}
*/ */
this.endpoint = endpoint; this.endpoint = endpoint;
/** /**
* The time difference between Discord's Dates and the local computer's Dates. A positive number means the local * The time difference between Discord's Dates and the local computer's Dates. A positive number means the local
* computer's time is ahead of Discord's. * computer's time is ahead of Discord's.
* @type {Number} * @type {number}
*/ */
this.timeDifference = 0; this.timeDifference = 0;
} }

18
src/client/voice/ClientVoiceManager.js
View File

@@ -16,12 +16,12 @@ class ClientVoiceManager {
this.client = client; this.client = client;
/** /**
* A collection mapping connection IDs to the Connection objects * A collection mapping connection IDs to the Connection objects
* @type {Collection<String, VoiceConnection>} * @type {Collection<string, VoiceConnection>}
*/ */
this.connections = new Collection(); this.connections = new Collection();
/** /**
* Pending connection attempts, maps Guild ID to VoiceChannel * Pending connection attempts, maps Guild ID to VoiceChannel
* @type {Collection<String, VoiceChannel>} * @type {Collection<string, VoiceChannel>}
*/ */
this.pending = new Collection(); this.pending = new Collection();
} }
@@ -29,7 +29,7 @@ class ClientVoiceManager {
/** /**
* Checks whether a pending request can be processed * Checks whether a pending request can be processed
* @private * @private
* @param {String} guildID The ID of the Guild * @param {string} guildID The ID of the Guild
*/ */
_checkPendingReady(guildID) { _checkPendingReady(guildID) {
const pendingRequest = this.pending.get(guildID); const pendingRequest = this.pending.get(guildID);
@@ -49,9 +49,9 @@ class ClientVoiceManager {
/** /**
* Called when the Client receives information about this voice server update. * Called when the Client receives information about this voice server update.
* @param {String} guildID the ID of the Guild * @param {string} guildID the ID of the Guild
* @param {String} token the token to authorise with * @param {string} token the token to authorise with
* @param {String} endpoint the endpoint to connect to * @param {string} endpoint the endpoint to connect to
*/ */
_receivedVoiceServer(guildID, token, endpoint) { _receivedVoiceServer(guildID, token, endpoint) {
const pendingRequest = this.pending.get(guildID); const pendingRequest = this.pending.get(guildID);
@@ -66,8 +66,8 @@ class ClientVoiceManager {
/** /**
* Called when the Client receives information about the voice state update. * Called when the Client receives information about the voice state update.
* @param {String} guildID the ID of the Guild * @param {string} guildID the ID of the Guild
* @param {String} sessionID the session id to authorise with * @param {string} sessionID the session id to authorise with
*/ */
_receivedVoiceStateUpdate(guildID, sessionID) { _receivedVoiceStateUpdate(guildID, sessionID) {
const pendingRequest = this.pending.get(guildID); const pendingRequest = this.pending.get(guildID);
@@ -99,7 +99,7 @@ class ClientVoiceManager {
/** /**
* Sets up a request to join a voice channel * Sets up a request to join a voice channel
* @param {VoiceChannel} channel the voice channel to join * @param {VoiceChannel} channel the voice channel to join
* @returns {null} * @returns {void}
*/ */
joinChannel(channel) { joinChannel(channel) {
return new Promise((resolve, reject) => { return new Promise((resolve, reject) => {

18
src/client/voice/VoiceConnection.js
View File

@@ -25,7 +25,7 @@ class VoiceConnection extends EventEmitter {
this.player = new DefaultPlayer(this); this.player = new DefaultPlayer(this);
/** /**
* The endpoint of the connection * The endpoint of the connection
* @type {String} * @type {string}
*/ */
this.endpoint = endpoint; this.endpoint = endpoint;
/** /**
@@ -41,18 +41,18 @@ class VoiceConnection extends EventEmitter {
this.websocket = new VoiceConnectionWebSocket(this, channel.guild.id, token, sessionID, endpoint); this.websocket = new VoiceConnectionWebSocket(this, channel.guild.id, token, sessionID, endpoint);
/** /**
* Whether or not the connection is ready * Whether or not the connection is ready
* @type {Boolean} * @type {boolean}
*/ */
this.ready = false; this.ready = false;
/** /**
* The resolve function for the promise associated with creating this connection * The resolve function for the promise associated with creating this connection
* @type {Function} * @type {function}
* @private * @private
*/ */
this._resolve = resolve; this._resolve = resolve;
/** /**
* The reject function for the promise associated with creating this connection * The reject function for the promise associated with creating this connection
* @type {Function} * @type {function}
* @private * @private
*/ */
this._reject = reject; this._reject = reject;
@@ -66,7 +66,7 @@ class VoiceConnection extends EventEmitter {
* Executed whenever an error occurs with the UDP/WebSocket sub-client * Executed whenever an error occurs with the UDP/WebSocket sub-client
* @private * @private
* @param {Error} error * @param {Error} error
* @returns {null} * @returns {void}
*/ */
_onError(e) { _onError(e) {
this._reject(e); this._reject(e);
@@ -82,7 +82,7 @@ class VoiceConnection extends EventEmitter {
/** /**
* Disconnects the Client from the Voice Channel * Disconnects the Client from the Voice Channel
* @param {string} [reason='user requested'] the reason of the disconnection * @param {string} [reason='user requested'] the reason of the disconnection
* @returns {null} * @returns {void}
*/ */
disconnect(reason = 'user requested') { disconnect(reason = 'user requested') {
this.manager.client.ws.send({ this.manager.client.ws.send({
@@ -122,7 +122,7 @@ class VoiceConnection extends EventEmitter {
/** /**
* Binds listeners to the WebSocket and UDP sub-clients * Binds listeners to the WebSocket and UDP sub-clients
* @returns {null} * @returns {void}
* @private * @private
*/ */
bindListeners() { bindListeners() {
@@ -195,7 +195,7 @@ class VoiceConnection extends EventEmitter {
* Emitted whenever a user starts/stops speaking * Emitted whenever a user starts/stops speaking
* @event VoiceConnection#speaking * @event VoiceConnection#speaking
* @param {User} user the user that has started/stopped speaking * @param {User} user the user that has started/stopped speaking
* @param {Boolean} speaking whether or not the user is speaking * @param {boolean} speaking whether or not the user is speaking
*/ */
if (this.ready) { if (this.ready) {
this.emit('speaking', user, data.speaking); this.emit('speaking', user, data.speaking);
@@ -208,7 +208,7 @@ class VoiceConnection extends EventEmitter {
/** /**
* Play the given file in the voice connection * Play the given file in the voice connection
* @param {String} filepath the path to the file * @param {string} filepath the path to the file
* @returns {StreamDispatcher} * @returns {StreamDispatcher}
* @example * @example
* // play files natively * // play files natively

10
src/client/voice/dispatcher/StreamDispatcher.js
View File

@@ -26,7 +26,7 @@ class StreamDispatcher extends EventEmitter {
/** /**
* Emitted when the dispatcher starts/stops speaking * Emitted when the dispatcher starts/stops speaking
* @event StreamDispatcher#speaking * @event StreamDispatcher#speaking
* @param {Boolean} value whether or not the dispatcher is speaking * @param {boolean} value whether or not the dispatcher is speaking
*/ */
_setSpeaking(value) { _setSpeaking(value) {
this.speaking = value; this.speaking = value;
@@ -129,7 +129,7 @@ class StreamDispatcher extends EventEmitter {
/** /**
* Emitted when the stream wants to give debug information. * Emitted when the stream wants to give debug information.
* @event StreamDispatcher#debug * @event StreamDispatcher#debug
* @param {String} information the debug information * @param {string} information the debug information
*/ */
this.emit('debug', `triggered terminal state ${state} - stream is now dead`); this.emit('debug', `triggered terminal state ${state} - stream is now dead`);
this._triggered = true; this._triggered = true;
@@ -172,7 +172,7 @@ class StreamDispatcher extends EventEmitter {
/** /**
* Stops the current stream permanently and emits an `end` event. * Stops the current stream permanently and emits an `end` event.
* @returns {null} * @returns {void}
*/ */
end() { end() {
this._triggerTerminalState('end', 'user requested'); this._triggerTerminalState('end', 'user requested');
@@ -180,7 +180,7 @@ class StreamDispatcher extends EventEmitter {
/** /**
* Stops sending voice packets to the voice connection (stream may still progress however) * Stops sending voice packets to the voice connection (stream may still progress however)
* @returns {null} * @returns {void}
*/ */
pause() { pause() {
this._pause(true); this._pause(true);
@@ -188,7 +188,7 @@ class StreamDispatcher extends EventEmitter {
/** /**
* Resumes sending voice packets to the voice connection (may be further on in the stream than when paused) * Resumes sending voice packets to the voice connection (may be further on in the stream than when paused)
* @returns {null} * @returns {void}
*/ */
resume() { resume() {
this._pause(false); this._pause(false);

2
src/client/voice/receiver/VoiceReceiver.js
View File

@@ -89,7 +89,7 @@ class VoiceReceiver extends EventEmitter {
/** /**
* Emitted whenever a voice packet cannot be decrypted * Emitted whenever a voice packet cannot be decrypted
* @event VoiceReceiver#warn * @event VoiceReceiver#warn
* @param {String} message the warning message * @param {string} message the warning message
*/ */
return this.emit('warn', 'failed to decrypt voice packet'); return this.emit('warn', 'failed to decrypt voice packet');
} }

30
src/client/websocket/WebSocketManager.js
View File

@@ -23,33 +23,33 @@ class WebSocketManager {
this.packetManager = new PacketManager(this); this.packetManager = new PacketManager(this);
/** /**
* The status of the WebSocketManager, a type of Constants.Status. It defaults to IDLE. * The status of the WebSocketManager, a type of Constants.Status. It defaults to IDLE.
* @type {Number} * @type {number}
*/ */
this.status = Constants.Status.IDLE; this.status = Constants.Status.IDLE;
/** /**
* The session ID of the connection, null if not yet available. * The session ID of the connection, null if not yet available.
* @type {?String} * @type {?string}
*/ */
this.sessionID = null; this.sessionID = null;
/** /**
* The packet count of the client, null if not yet available. * The packet count of the client, null if not yet available.
* @type {?Number} * @type {?number}
*/ */
this.sequence = -1; this.sequence = -1;
/** /**
* The gateway address for this WebSocket connection, null if not yet available. * The gateway address for this WebSocket connection, null if not yet available.
* @type {?String} * @type {?string}
*/ */
this.gateway = null; this.gateway = null;
} }
/** /**
* Connects the client to a given gateway * Connects the client to a given gateway
* @param {String} gateway the gateway to connect to * @param {string} gateway the gateway to connect to
* @returns {null} * @returns {void}
*/ */
connect(gateway) { connect(gateway) {
this.status = Constants.Status.CONNECTING; this.status = Constants.Status.CONNECTING;
@@ -69,7 +69,7 @@ class WebSocketManager {
/** /**
* Sends a packet to the gateway * Sends a packet to the gateway
* @param {Object} packet An object that can be JSON stringified * @param {Object} packet An object that can be JSON stringified
* @returns {null} * @returns {void}
*/ */
send(data) { send(data) {
this._queue.push(JSON.stringify(data)); this._queue.push(JSON.stringify(data));
@@ -100,7 +100,7 @@ class WebSocketManager {
/** /**
* Run whenever the gateway connections opens up * Run whenever the gateway connections opens up
* @returns {null} * @returns {void}
*/ */
eventOpen() { eventOpen() {
if (this.reconnecting) { if (this.reconnecting) {
@@ -112,7 +112,7 @@ class WebSocketManager {
/** /**
* Sends a gatway resume packet, in cases of unexpected disconnections. * Sends a gatway resume packet, in cases of unexpected disconnections.
* @returns {null} * @returns {void}
*/ */
_sendResume() { _sendResume() {
const payload = { const payload = {
@@ -129,7 +129,7 @@ class WebSocketManager {
/** /**
* Sends a new identification packet, in cases of new connections or failed reconnections. * Sends a new identification packet, in cases of new connections or failed reconnections.
* @returns {null} * @returns {void}
*/ */
_sendNewIdentify() { _sendNewIdentify() {
this.reconnecting = false; this.reconnecting = false;
@@ -147,7 +147,7 @@ class WebSocketManager {
/** /**
* Run whenever the connection to the gateway is closed, it will try to reconnect the client. * Run whenever the connection to the gateway is closed, it will try to reconnect the client.
* @returns {null} * @returns {void}
*/ */
eventClose(event) { eventClose(event) {
if (event.code === 4004) { if (event.code === 4004) {
@@ -162,7 +162,7 @@ class WebSocketManager {
* Run whenever a message is received from the WebSocket. Returns `true` if the message * Run whenever a message is received from the WebSocket. Returns `true` if the message
* was handled properly. * was handled properly.
* @param {Object} data the received websocket data * @param {Object} data the received websocket data
* @returns {Boolean} * @returns {boolean}
*/ */
eventMessage($event) { eventMessage($event) {
let packet; let packet;
@@ -188,7 +188,7 @@ class WebSocketManager {
/** /**
* Run whenever an error occurs with the WebSocket connection. Tries to reconnect * Run whenever an error occurs with the WebSocket connection. Tries to reconnect
* @returns {null} * @returns {void}
*/ */
eventError(e) { eventError(e) {
/** /**
@@ -214,7 +214,7 @@ class WebSocketManager {
/** /**
* Runs on new packets before `READY` to see if the Client is ready yet, if it is prepares * Runs on new packets before `READY` to see if the Client is ready yet, if it is prepares
* the `READY` event. * the `READY` event.
* @returns {null} * @returns {void}
*/ */
checkIfReady() { checkIfReady() {
if (this.status !== Constants.Status.READY && this.status !== Constants.Status.NEARLY) { if (this.status !== Constants.Status.READY && this.status !== Constants.Status.NEARLY) {
@@ -238,7 +238,7 @@ class WebSocketManager {
/** /**
* Tries to reconnect the client, changing the status to Constants.Status.RECONNECTING. * Tries to reconnect the client, changing the status to Constants.Status.RECONNECTING.
* @returns {null} * @returns {void}
*/ */
tryReconnect() { tryReconnect() {
this.status = Constants.Status.RECONNECTING; this.status = Constants.Status.RECONNECTING;

2
src/client/websocket/packets/handlers/MessageDeleteBulk.js
View File

@@ -15,7 +15,7 @@ class MessageDeleteBulkHandler extends AbstractHandler {
* Emitted whenever a messages are deleted in bulk * Emitted whenever a messages are deleted in bulk
* *
* @event Client#messageDeleteBulk * @event Client#messageDeleteBulk
* @param {Collection<String, Message>} messages The deleted messages, mapped by their ID * @param {Collection<string, Message>} messages The deleted messages, mapped by their ID
*/ */
module.exports = MessageDeleteBulkHandler; module.exports = MessageDeleteBulkHandler;

4
src/structures/Channel.js
View File

@@ -19,7 +19,7 @@ class Channel {
* * `group` - a Group DM channel * * `group` - a Group DM channel
* * `text` - a guild text channel * * `text` - a guild text channel
* * `voice` - a guild voice channel * * `voice` - a guild voice channel
* @type {String} * @type {string}
*/ */
this.type = null; this.type = null;
if (data) { if (data) {
@@ -30,7 +30,7 @@ class Channel {
setup(data) { setup(data) {
/** /**
* The unique ID of the channel * The unique ID of the channel
* @type {String} * @type {string}
*/ */
this.id = data.id; this.id = data.id;
} }

14
src/structures/ClientUser.js
View File

@@ -9,12 +9,12 @@ class ClientUser extends User {
super.setup(data); super.setup(data);
/** /**
* Whether or not this account has been verified * Whether or not this account has been verified
* @type {Boolean} * @type {boolean}
*/ */
this.verified = data.verified; this.verified = data.verified;
/** /**
* The email of this account * The email of this account
* @type {String} * @type {string}
*/ */
this.email = data.email; this.email = data.email;
@@ -25,7 +25,7 @@ class ClientUser extends User {
* Set the username of the logged in Client. * Set the username of the logged in Client.
* <info>Changing usernames in Discord is heavily rate limited, with only 2 requests * <info>Changing usernames in Discord is heavily rate limited, with only 2 requests
* every hour. Use this sparingly!</info> * every hour. Use this sparingly!</info>
* @param {String} username the new username * @param {string} username the new username
* @returns {Promise<ClientUser>} * @returns {Promise<ClientUser>}
* @example * @example
* // set username * // set username
@@ -40,7 +40,7 @@ class ClientUser extends User {
/** /**
* If this user is a "self bot" or logged in using a normal user's details (which should be avoided), you can set the * If this user is a "self bot" or logged in using a normal user's details (which should be avoided), you can set the
* email here. * email here.
* @param {String} email the new email * @param {string} email the new email
* @returns {Promise<ClientUser>} * @returns {Promise<ClientUser>}
* @example * @example
* // set email * // set email
@@ -55,7 +55,7 @@ class ClientUser extends User {
/** /**
* If this user is a "self bot" or logged in using a normal user's details (which should be avoided), you can set the * If this user is a "self bot" or logged in using a normal user's details (which should be avoided), you can set the
* password here. * password here.
* @param {String} password the new password * @param {string} password the new password
* @returns {Promise<ClientUser>} * @returns {Promise<ClientUser>}
* @example * @example
* // set password * // set password
@@ -83,8 +83,8 @@ class ClientUser extends User {
/** /**
* Set the status and playing game of the logged in client. * Set the status and playing game of the logged in client.
* @param {String} [status] the status, can be `online` or `idle`. * @param {string} [status] the status, can be `online` or `idle`.
* @param {String|Object} [game] the game that is being played * @param {string|Object} [game] the game that is being played
* @returns {Promise<ClientUser, Error>} * @returns {Promise<ClientUser, Error>}
* @example * @example
* // set status * // set status

4
src/structures/DMChannel.js
View File

@@ -24,7 +24,7 @@ class DMChannel extends Channel {
this.recipient = recipient; this.recipient = recipient;
/** /**
* The ID of the last sent message, if available * The ID of the last sent message, if available
* @type {?String} * @type {?string}
*/ */
this.lastMessageID = data.last_message_id; this.lastMessageID = data.last_message_id;
this.type = 'dm'; this.type = 'dm';
@@ -33,7 +33,7 @@ class DMChannel extends Channel {
/** /**
* When concatenated with a String, this automatically concatenates the recipient's mention instead of the * When concatenated with a String, this automatically concatenates the recipient's mention instead of the
* DM channel object. * DM channel object.
* @returns {String} * @returns {string}
*/ */
toString() { toString() {
return this.recipient.toString(); return this.recipient.toString();

14
src/structures/Emoji.js
View File

@@ -22,30 +22,30 @@ class Emoji {
setup(data) { setup(data) {
/** /**
* The ID of the Emoji * The ID of the Emoji
* @type {String} * @type {string}
*/ */
this.id = data.id; this.id = data.id;
/** /**
* The name of the Emoji * The name of the Emoji
* @type {String} * @type {string}
*/ */
this.name = data.name; this.name = data.name;
this.roleIDS = data.roles; this.roleIDS = data.roles;
/** /**
* Whether or not this emoji requires colons surrounding it * Whether or not this emoji requires colons surrounding it
* @type {Boolean} * @type {boolean}
*/ */
this.requiresColons = data.require_colons; this.requiresColons = data.require_colons;
/** /**
* Whether this emoji is managed by an external service * Whether this emoji is managed by an external service
* @type {Boolean} * @type {boolean}
*/ */
this.managed = data.managed; this.managed = data.managed;
} }
/** /**
* A collection of roles this emoji is active for (empty if all). Mapped by role ID. * A collection of roles this emoji is active for (empty if all). Mapped by role ID.
* @type {Collection<String, Role>} * @type {Collection<string, Role>}
* @readonly * @readonly
*/ */
get roles() { get roles() {
@@ -60,7 +60,7 @@ class Emoji {
/** /**
* The URL to the emoji file * The URL to the emoji file
* @type {String} * @type {string}
* @readonly * @readonly
*/ */
get url() { get url() {
@@ -69,7 +69,7 @@ class Emoji {
/** /**
* When concatenated with a String, this automatically returns the emoji mention rather than the object. * When concatenated with a String, this automatically returns the emoji mention rather than the object.
* @returns {String} * @returns {string}
* @example * @example
* // send an emoji: * // send an emoji:
* const emoji = guild.emojis.array()[0]; * const emoji = guild.emojis.array()[0];

10
src/structures/EvaluatedPermissions.js
View File

@@ -13,7 +13,7 @@ class EvaluatedPermissions {
/** /**
* A number representing the packed permissions. * A number representing the packed permissions.
* @private * @private
* @type {Number} * @type {number}
*/ */
this.permissions = permissions; this.permissions = permissions;
} }
@@ -21,7 +21,7 @@ class EvaluatedPermissions {
/** /**
* Get an object mapping permission name, e.g. `READ_MESSAGES` to a boolean - whether the user * Get an object mapping permission name, e.g. `READ_MESSAGES` to a boolean - whether the user
* can perform this or not. * can perform this or not.
* @returns {Object<String, Boolean>} * @returns {Object<string, boolean>}
*/ */
serialize() { serialize() {
const serializedPermissions = {}; const serializedPermissions = {};
@@ -34,9 +34,9 @@ class EvaluatedPermissions {
/** /**
* Checks whether a user has a certain permission, e.g. `READ_MESSAGES`. * Checks whether a user has a certain permission, e.g. `READ_MESSAGES`.
* @param {String} permission the permission to check for * @param {string} permission the permission to check for
* @param {Boolean} [explicit=false] whether the user should explicitly have the permission. * @param {boolean} [explicit=false] whether the user should explicitly have the permission.
* @returns {Boolean} * @returns {boolean}
*/ */
hasPermission(permission, explicit = false) { hasPermission(permission, explicit = false) {
if (permission instanceof String || typeof permission === 'string') { if (permission instanceof String || typeof permission === 'string') {

10
src/structures/GroupDMChannel.js
View File

@@ -77,7 +77,7 @@ class GroupDMChannel extends Channel {
if (!this.recipients) { if (!this.recipients) {
/** /**
* A collection of the recipients of this DM, mapped by their ID. * A collection of the recipients of this DM, mapped by their ID.
* @type {Collection<String, User>} * @type {Collection<string, User>}
*/ */
this.recipients = new Collection(); this.recipients = new Collection();
} }
@@ -90,22 +90,22 @@ class GroupDMChannel extends Channel {
} }
/** /**
* The name of this Group DM, can be null if one isn't set. * The name of this Group DM, can be null if one isn't set.
* @type {String} * @type {string}
*/ */
this.name = data.name; this.name = data.name;
/** /**
* The ID of this Group DM Channel. * The ID of this Group DM Channel.
* @type {String} * @type {string}
*/ */
this.id = data.id; this.id = data.id;
/** /**
* A hash of the Group DM icon. * A hash of the Group DM icon.
* @type {String} * @type {string}
*/ */
this.icon = data.icon; this.icon = data.icon;
/** /**
* The ID of the last message in the channel, if one was sent. * The ID of the last message in the channel, if one was sent.
* @type {?String} * @type {?string}
*/ */
this.lastMessageID = data.last_message_id; this.lastMessageID = data.last_message_id;
/** /**

56
src/structures/Guild.js
View File

@@ -34,19 +34,19 @@ class Guild {
/** /**
* A Collection of members that are in this Guild. The key is the member's ID, the value is the member. * A Collection of members that are in this Guild. The key is the member's ID, the value is the member.
* @type {Collection<String, GuildMember>} * @type {Collection<string, GuildMember>}
*/ */
this.members = new Collection(); this.members = new Collection();
/** /**
* A Collection of channels that are in this Guild. The key is the channel's ID, the value is the channel. * A Collection of channels that are in this Guild. The key is the channel's ID, the value is the channel.
* @type {Collection<String, GuildChannel>} * @type {Collection<string, GuildChannel>}
*/ */
this.channels = new Collection(); this.channels = new Collection();
/** /**
* A Collection of roles that are in this Guild. The key is the role's ID, the value is the role. * A Collection of roles that are in this Guild. The key is the role's ID, the value is the role.
* @type {Collection<String, Role>} * @type {Collection<string, Role>}
*/ */
this.roles = new Collection(); this.roles = new Collection();
@@ -57,12 +57,12 @@ class Guild {
if (data.unavailable) { if (data.unavailable) {
/** /**
* Whether the Guild is available to access. If it is not available, it indicates a server outage. * Whether the Guild is available to access. If it is not available, it indicates a server outage.
* @type {Boolean} * @type {boolean}
*/ */
this.available = false; this.available = false;
/** /**
* The Unique ID of the Guild, useful for comparisons. * The Unique ID of the Guild, useful for comparisons.
* @type {String} * @type {string}
*/ */
this.id = data.id; this.id = data.id;
} else { } else {
@@ -152,7 +152,7 @@ class Guild {
/** /**
* When concatenated with a String, this automatically concatenates the Guild's name instead of the Guild object. * When concatenated with a String, this automatically concatenates the Guild's name instead of the Guild object.
* @returns {String} * @returns {string}
* @example * @example
* // logs: Hello from My Guild! * // logs: Hello from My Guild!
* console.log(`Hello from ${guild}!`); * console.log(`Hello from ${guild}!`);
@@ -181,7 +181,7 @@ class Guild {
* it is advisable to just compare `guild.id === guild2.id` as it is much faster and is often * it is advisable to just compare `guild.id === guild2.id` as it is much faster and is often
* what most users need. * what most users need.
* @param {Guild} guild the guild to compare * @param {Guild} guild the guild to compare
* @returns {Boolean} * @returns {boolean}
*/ */
equals(data) { equals(data) {
let base = let base =
@@ -220,7 +220,7 @@ class Guild {
* Emitted once a Guild Member starts/stops speaking * Emitted once a Guild Member starts/stops speaking
* @event Client#guildMemberSpeaking * @event Client#guildMemberSpeaking
* @param {GuildMember} member the member that started/stopped speaking * @param {GuildMember} member the member that started/stopped speaking
* @param {Boolean} speaking whether or not the member is speaking * @param {boolean} speaking whether or not the member is speaking
*/ */
this.client.emit(Constants.Events.GUILD_MEMBER_SPEAKING, member, speaking); this.client.emit(Constants.Events.GUILD_MEMBER_SPEAKING, member, speaking);
} }
@@ -228,8 +228,8 @@ class Guild {
/** /**
* Sets up the Guild * Sets up the Guild
* @param {any} data * @param {*} data
* @returns {null} * @returns {void}
* @private * @private
*/ */
setup(data) { setup(data) {
@@ -237,33 +237,33 @@ class Guild {
this.available = !data.unavailable; this.available = !data.unavailable;
/** /**
* The hash of the guild splash image, or null if no splash (VIP only) * The hash of the guild splash image, or null if no splash (VIP only)
* @type {?String} * @type {?string}
*/ */
this.splash = data.splash; this.splash = data.splash;
/** /**
* The region the guild is located in * The region the guild is located in
* @type {String} * @type {string}
*/ */
this.region = data.region; this.region = data.region;
/** /**
* The name of the guild * The name of the guild
* @type {String} * @type {string}
*/ */
this.name = data.name; this.name = data.name;
/** /**
* The full amount of members in this Guild as of `READY` * The full amount of members in this Guild as of `READY`
* @type {Number} * @type {number}
*/ */
this.memberCount = data.member_count; this.memberCount = data.member_count;
/** /**
* Whether the guild is "large" (has more than 250 members) * Whether the guild is "large" (has more than 250 members)
* @type {Boolean} * @type {boolean}
*/ */
this.large = data.large; this.large = data.large;
this._joinDate = new Date(data.joined_at).getTime(); this._joinDate = new Date(data.joined_at).getTime();
/** /**
* The hash of the guild icon, or null if there is no icon. * The hash of the guild icon, or null if there is no icon.
* @type {?String} * @type {?string}
*/ */
this.icon = data.icon; this.icon = data.icon;
/** /**
@@ -281,22 +281,22 @@ class Guild {
} }
/** /**
* The time in seconds before a user is counted as "away from keyboard". * The time in seconds before a user is counted as "away from keyboard".
* @type {?Number} * @type {?number}
*/ */
this.afkTimeout = data.afk_timeout; this.afkTimeout = data.afk_timeout;
/** /**
* The ID of the voice channel where AFK members are moved. * The ID of the voice channel where AFK members are moved.
* @type {?String} * @type {?string}
*/ */
this.afkChannelID = data.afk_channel_id; this.afkChannelID = data.afk_channel_id;
/** /**
* Whether embedded images are enabled on this guild. * Whether embedded images are enabled on this guild.
* @type {Boolean} * @type {boolean}
*/ */
this.embedEnabled = data.embed_enabled; this.embedEnabled = data.embed_enabled;
/** /**
* The verification level of the guild. * The verification level of the guild.
* @type {Number} * @type {number}
*/ */
this.verificationLevel = data.verification_level; this.verificationLevel = data.verification_level;
this.features = data.features || []; this.features = data.features || [];
@@ -365,8 +365,8 @@ class Guild {
/** /**
* Creates a new Channel in the Guild. * Creates a new Channel in the Guild.
* @param {String} name the name of the new channel. * @param {string} name the name of the new channel.
* @param {String} type the type of the new channel, either `text` or `voice`. * @param {string} type the type of the new channel, either `text` or `voice`.
* @returns {Promise<TextChannel|VoiceChannel, Error>} * @returns {Promise<TextChannel|VoiceChannel, Error>}
* @example * @example
* // create a new text channel * // create a new text channel
@@ -436,7 +436,7 @@ class Guild {
/** /**
* Edit the name of the Guild. * Edit the name of the Guild.
* @param {String} name the new name of the Guild. * @param {string} name the new name of the Guild.
* @returns {Promise<Guild, Error>} * @returns {Promise<Guild, Error>}
* @example * @example
* // edit the guild name * // edit the guild name
@@ -492,7 +492,7 @@ class Guild {
/** /**
* Edit the AFK timeout of the Guild. * Edit the AFK timeout of the Guild.
* @param {Number} afkTimeout the time in seconds that a user must be idle to be considered AFK. * @param {number} afkTimeout the time in seconds that a user must be idle to be considered AFK.
* @returns {Promise<Guild, Error>} * @returns {Promise<Guild, Error>}
* @example * @example
* // edit the guild AFK channel * // edit the guild AFK channel
@@ -562,7 +562,7 @@ class Guild {
/** /**
* Fetch a Collection of banned users in this Guild. * Fetch a Collection of banned users in this Guild.
* @returns {Promise<Collection<String, User>, Error>} * @returns {Promise<Collection<string, User>, Error>}
*/ */
fetchBans() { fetchBans() {
return this.client.rest.methods.getGuildBans(this); return this.client.rest.methods.getGuildBans(this);
@@ -570,7 +570,7 @@ class Guild {
/** /**
* Fetch a Collection of invites to this Guild. Resolves with a Collection mapping invites by their codes. * Fetch a Collection of invites to this Guild. Resolves with a Collection mapping invites by their codes.
* @returns {Promise<Collection<String, Invite>, Error>} * @returns {Promise<Collection<string, Invite>, Error>}
*/ */
fetchInvites() { fetchInvites() {
return this.client.rest.methods.getGuildInvites(this); return this.client.rest.methods.getGuildInvites(this);
@@ -579,7 +579,7 @@ class Guild {
/** /**
* Fetches all the members in the Guild, even if they are offline. If the Guild has less than 250 members, * Fetches all the members in the Guild, even if they are offline. If the Guild has less than 250 members,
* this should not be necessary. * this should not be necessary.
* @param {String} [query=''] An optional query to provide when fetching members * @param {string} [query=''] An optional query to provide when fetching members
* @returns {Promise<Guild, Error>} * @returns {Promise<Guild, Error>}
*/ */
fetchMembers(query = '') { fetchMembers(query = '') {
@@ -606,7 +606,7 @@ class Guild {
/** /**
* Gets the URL to this guild's icon (if it has one, otherwise it returns null) * Gets the URL to this guild's icon (if it has one, otherwise it returns null)
* @type {?String} * @type {?string}
* @readonly * @readonly
*/ */
get iconURL() { get iconURL() {

18
src/structures/GuildChannel.js
View File

@@ -33,23 +33,23 @@ class GuildChannel extends Channel {
super.setup(data); super.setup(data);
/** /**
* The topic of the Guild Channel, if there is one. * The topic of the Guild Channel, if there is one.
* @type {?String} * @type {?string}
*/ */
this.topic = data.topic; this.topic = data.topic;
/** /**
* The position of the channel in the list. * The position of the channel in the list.
* @type {Number} * @type {number}
*/ */
this.position = data.position; this.position = data.position;
/** /**
* The name of the Guild Channel * The name of the Guild Channel
* @type {String} * @type {string}
*/ */
this.name = data.name; this.name = data.name;
this.ow = data.permission_overwrites; this.ow = data.permission_overwrites;
/** /**
* A map of permission overwrites in this channel for roles and users. * A map of permission overwrites in this channel for roles and users.
* @type {Collection<String, PermissionOverwrites>} * @type {Collection<string, PermissionOverwrites>}
*/ */
this.permissionOverwrites = new Collection(); this.permissionOverwrites = new Collection();
if (data.permission_overwrites) { if (data.permission_overwrites) {
@@ -63,7 +63,7 @@ class GuildChannel extends Channel {
* Checks if this channel has the same type, topic, position, name, overwrites and ID as another channel. * Checks if this channel has the same type, topic, position, name, overwrites and ID as another channel.
* In most cases, a simple `channel.id === channel2.id` will do, and is much faster too. * In most cases, a simple `channel.id === channel2.id` will do, and is much faster too.
* @param {GuildChannel} channel the channel to compare this channel to * @param {GuildChannel} channel the channel to compare this channel to
* @returns {Boolean} * @returns {boolean}
*/ */
equals(other) { equals(other) {
let base = ( let base = (
@@ -222,7 +222,7 @@ class GuildChannel extends Channel {
/** /**
* Set a new name for the Guild Channel * Set a new name for the Guild Channel
* @param {String} name the new name for the guild channel * @param {string} name the new name for the guild channel
* @returns {Promise<GuildChannel>} * @returns {Promise<GuildChannel>}
* @example * @example
* // set a new channel name * // set a new channel name
@@ -236,7 +236,7 @@ class GuildChannel extends Channel {
/** /**
* Set a new position for the Guild Channel * Set a new position for the Guild Channel
* @param {Number} position the new position for the guild channel * @param {number} position the new position for the guild channel
* @returns {Promise<GuildChannel>} * @returns {Promise<GuildChannel>}
* @example * @example
* // set a new channel position * // set a new channel position
@@ -250,7 +250,7 @@ class GuildChannel extends Channel {
/** /**
* Set a new topic for the Guild Channel * Set a new topic for the Guild Channel
* @param {String} topic the new topic for the guild channel * @param {string} topic the new topic for the guild channel
* @returns {Promise<GuildChannel>} * @returns {Promise<GuildChannel>}
* @example * @example
* // set a new channel topic * // set a new channel topic
@@ -264,7 +264,7 @@ class GuildChannel extends Channel {
/** /**
* When concatenated with a String, this automatically returns the Channel's mention instead of the Channel object. * When concatenated with a String, this automatically returns the Channel's mention instead of the Channel object.
* @returns {String} * @returns {string}
* @example * @example
* // Outputs: Hello from #general * // Outputs: Hello from #general
* console.log(`Hello from ${channel}`); * console.log(`Hello from ${channel}`);

30
src/structures/GuildMember.js
View File

@@ -31,43 +31,43 @@ class GuildMember {
this.user = data.user; this.user = data.user;
/** /**
* Whether this member is deafened server-wide * Whether this member is deafened server-wide
* @type {Boolean} * @type {boolean}
*/ */
this.serverDeaf = data.deaf; this.serverDeaf = data.deaf;
/** /**
* Whether this member is muted server-wide * Whether this member is muted server-wide
* @type {Boolean} * @type {boolean}
*/ */
this.serverMute = data.mute; this.serverMute = data.mute;
/** /**
* Whether this member is self-muted * Whether this member is self-muted
* @type {Boolean} * @type {boolean}
*/ */
this.selfMute = data.self_mute; this.selfMute = data.self_mute;
/** /**
* Whether this member is self-deafened * Whether this member is self-deafened
* @type {Boolean} * @type {boolean}
*/ */
this.selfDeaf = data.self_deaf; this.selfDeaf = data.self_deaf;
/** /**
* The voice session ID of this member, if any * The voice session ID of this member, if any
* @type {?String} * @type {?string}
*/ */
this.voiceSessionID = data.session_id; this.voiceSessionID = data.session_id;
/** /**
* The voice channel ID of this member, if any * The voice channel ID of this member, if any
* @type {?String} * @type {?string}
*/ */
this.voiceChannelID = data.channel_id; this.voiceChannelID = data.channel_id;
this._joinDate = new Date(data.joined_at).getTime(); this._joinDate = new Date(data.joined_at).getTime();
/** /**
* Whether this meember is speaking * Whether this meember is speaking
* @type {?Boolean} * @type {?boolean}
*/ */
this.speaking = this.speaking; this.speaking = this.speaking;
/** /**
* The nickname of this Guild Member, if they have one * The nickname of this Guild Member, if they have one
* @type {?String} * @type {?string}
*/ */
this.nickname = data.nick; this.nickname = data.nick;
this._roles = data.roles; this._roles = data.roles;
@@ -106,7 +106,7 @@ class GuildMember {
/** /**
* Whether this member is muted in any way * Whether this member is muted in any way
* @type {Boolean} * @type {boolean}
* @readonly * @readonly
*/ */
get mute() { get mute() {
@@ -115,7 +115,7 @@ class GuildMember {
/** /**
* Whether this member is deafened in any way * Whether this member is deafened in any way
* @type {Boolean} * @type {boolean}
* @readonly * @readonly
*/ */
get deaf() { get deaf() {
@@ -133,7 +133,7 @@ class GuildMember {
/** /**
* The ID of this User * The ID of this User
* @type {String} * @type {string}
* @readonly * @readonly
*/ */
get id() { get id() {
@@ -142,7 +142,7 @@ class GuildMember {
/** /**
* Mute/unmute a user * Mute/unmute a user
* @param {Boolean} mute whether or not the member should be muted * @param {boolean} mute whether or not the member should be muted
* @returns {Promise<GuildMember, Error>} * @returns {Promise<GuildMember, Error>}
*/ */
setMute(mute) { setMute(mute) {
@@ -151,7 +151,7 @@ class GuildMember {
/** /**
* Deafen/undeafen a user * Deafen/undeafen a user
* @param {Boolean} deaf whether or not the member should be deafened * @param {boolean} deaf whether or not the member should be deafened
* @returns {Promise<GuildMember, Error>} * @returns {Promise<GuildMember, Error>}
*/ */
setDeaf(deaf) { setDeaf(deaf) {
@@ -169,7 +169,7 @@ class GuildMember {
/** /**
* Sets the Roles applied to the member. * Sets the Roles applied to the member.
* @param {Collection<String, Role>|Array<Role>} roles the roles to apply * @param {Collection<string, Role>|Array<Role>} roles the roles to apply
* @returns {Promise<GuildMember, Error>} * @returns {Promise<GuildMember, Error>}
*/ */
setRoles(roles) { setRoles(roles) {
@@ -178,7 +178,7 @@ class GuildMember {
/** /**
* Set the nickname for the Guild Member * Set the nickname for the Guild Member
* @param {String} nick the nickname for the Guild Member * @param {string} nick the nickname for the Guild Member
* @returns {Promise<GuildMember, Error>} * @returns {Promise<GuildMember, Error>}
*/ */
setNickname(nick) { setNickname(nick) {

10
src/structures/Invite.js
View File

@@ -38,32 +38,32 @@ class Invite {
setup(data) { setup(data) {
/** /**
* The maximum age of the invite, in seconds * The maximum age of the invite, in seconds
* @type {?Number} * @type {?number}
*/ */
this.maxAge = data.max_age; this.maxAge = data.max_age;
/** /**
* The code for this invite * The code for this invite
* @type {String} * @type {string}
*/ */
this.code = data.code; this.code = data.code;
this._creationDate = new Date(data.created_at).getTime(); this._creationDate = new Date(data.created_at).getTime();
/** /**
* Whether or not this invite is temporary * Whether or not this invite is temporary
* @type {Boolean} * @type {boolean}
*/ */
this.temporary = data.temporary; this.temporary = data.temporary;
/** /**
* How many times this invite has been used * How many times this invite has been used
* @type {Number} * @type {number}
*/ */
this.uses = data.uses; this.uses = data.uses;
/** /**
* The maximum uses of this invite * The maximum uses of this invite
* @type {Number} * @type {number}
*/ */
this.maxUses = data.max_uses; this.maxUses = data.max_uses;

30
src/structures/Message.js
View File

@@ -34,7 +34,7 @@ class Message {
setup(data) { setup(data) {
/** /**
* Whether or not this message is pinned * Whether or not this message is pinned
* @type {Boolean} * @type {boolean}
*/ */
this.pinned = data.pinned; this.pinned = data.pinned;
/** /**
@@ -52,19 +52,19 @@ class Message {
} }
/** /**
* The content of the message * The content of the message
* @type {String} * @type {string}
*/ */
this.content = data.content; this.content = data.content;
this._timestamp = new Date(data.timestamp).getTime(); this._timestamp = new Date(data.timestamp).getTime();
this._editedTimestamp = data.edited_timestamp ? new Date(data.edited_timestamp).getTime() : null; this._editedTimestamp = data.edited_timestamp ? new Date(data.edited_timestamp).getTime() : null;
/** /**
* Whether or not the message was Text-To-Speech * Whether or not the message was Text-To-Speech
* @type {Boolean} * @type {boolean}
*/ */
this.tts = data.tts; this.tts = data.tts;
/** /**
* A random number used for checking message delivery * A random number used for checking message delivery
* @type {String} * @type {string}
*/ */
this.nonce = data.nonce; this.nonce = data.nonce;
/** /**
@@ -74,7 +74,7 @@ class Message {
this.embeds = data.embeds.map(e => new Embed(this, e)); this.embeds = data.embeds.map(e => new Embed(this, e));
/** /**
* A collection of attachments in the message - e.g. Pictures - mapped by their ID. * A collection of attachments in the message - e.g. Pictures - mapped by their ID.
* @type {Collection<String, MessageAttachment>} * @type {Collection<string, MessageAttachment>}
*/ */
this.attachments = new Collection(); this.attachments = new Collection();
for (const attachment of data.attachments) { for (const attachment of data.attachments) {
@@ -83,11 +83,11 @@ class Message {
/** /**
* An object containing a further users, roles or channels collections * An object containing a further users, roles or channels collections
* @type {Object} * @type {Object}
* @property {Collection<String, User>} mentions.users Mentioned users, maps their ID to the user object. * @property {Collection<string, User>} mentions.users Mentioned users, maps their ID to the user object.
* @property {Collection<String, Role>} mentions.roles Mentioned roles, maps their ID to the role object. * @property {Collection<string, Role>} mentions.roles Mentioned roles, maps their ID to the role object.
* @property {Collection<String, GuildChannel>} * @property {Collection<string, GuildChannel>}
* mentions.channels Mentioned channels, maps their ID to the channel object. * mentions.channels Mentioned channels, maps their ID to the channel object.
* @property {Boolean} mentions.everyone whether or not @everyone was mentioned. * @property {boolean} mentions.everyone whether or not @everyone was mentioned.
*/ */
this.mentions = { this.mentions = {
users: new Collection(), users: new Collection(),
@@ -97,7 +97,7 @@ class Message {
}; };
/** /**
* The ID of the message (unique in the channel it was sent) * The ID of the message (unique in the channel it was sent)
* @type {String} * @type {string}
*/ */
this.id = data.id; this.id = data.id;
@@ -132,7 +132,7 @@ class Message {
/** /**
* Whether or not this message was sent by Discord, not actually a user (e.g. pin notifications) * Whether or not this message was sent by Discord, not actually a user (e.g. pin notifications)
* @type {Boolean} * @type {boolean}
*/ */
this.system = false; this.system = false;
if (data.type === 6) { if (data.type === 6) {
@@ -234,7 +234,7 @@ class Message {
* method allows you to see if there are differences in content, embeds, attachments, nonce and tts properties. * method allows you to see if there are differences in content, embeds, attachments, nonce and tts properties.
* @param {Message} message The message to compare it to * @param {Message} message The message to compare it to
* @param {Object} rawData Raw data passed through the WebSocket about this message * @param {Object} rawData Raw data passed through the WebSocket about this message
* @returns {Boolean} * @returns {boolean}
*/ */
equals(message, rawData) { equals(message, rawData) {
const embedUpdate = !message.author && !message.attachments; const embedUpdate = !message.author && !message.attachments;
@@ -263,7 +263,7 @@ class Message {
/** /**
* Deletes the message * Deletes the message
* @param {Number} [timeout=0] How long to wait to delete the message in milliseconds * @param {number} [timeout=0] How long to wait to delete the message in milliseconds
* @returns {Promise<Message, Error>} * @returns {Promise<Message, Error>}
* @example * @example
* // delete a message * // delete a message
@@ -283,7 +283,7 @@ class Message {
/** /**
* Edit the content of a message * Edit the content of a message
* @param {String} content the new content of a message * @param {string} content the new content of a message
* @returns {Promise<Message, Error>} * @returns {Promise<Message, Error>}
* @example * @example
* // update the content of a message * // update the content of a message
@@ -297,7 +297,7 @@ class Message {
/** /**
* Reply to a message * Reply to a message
* @param {String} content the content of the message * @param {string} content the content of the message
* @param {MessageOptions} [options = {}] the options to provide * @param {MessageOptions} [options = {}] the options to provide
* @returns {Promise<Message, Error>} * @returns {Promise<Message, Error>}
* @example * @example

14
src/structures/MessageAttachment.js
View File

@@ -19,37 +19,37 @@ class MessageAttachment {
setup(data) { setup(data) {
/** /**
* The ID of this attachment * The ID of this attachment
* @type {String} * @type {string}
*/ */
this.id = data.id; this.id = data.id;
/** /**
* The file name of this attachment * The file name of this attachment
* @type {String} * @type {string}
*/ */
this.filename = data.filename; this.filename = data.filename;
/** /**
* The size of this attachment in bytes * The size of this attachment in bytes
* @type {Number} * @type {number}
*/ */
this.filesize = data.size; this.filesize = data.size;
/** /**
* The URL to this attachment * The URL to this attachment
* @type {String} * @type {string}
*/ */
this.url = data.url; this.url = data.url;
/** /**
* The Proxy URL to this attachment * The Proxy URL to this attachment
* @type {String} * @type {string}
*/ */
this.proxyURL = data.url; this.proxyURL = data.url;
/** /**
* The height of this attachment (if an image) * The height of this attachment (if an image)
* @type {?Number} * @type {?number}
*/ */
this.height = data.height; this.height = data.height;
/** /**
* The width of this attachment (if an image) * The width of this attachment (if an image)
* @type {?Number} * @type {?number}
*/ */
this.width = data.width; this.width = data.width;
} }

20
src/structures/MessageEmbed.js
View File

@@ -14,22 +14,22 @@ class MessageEmbedThumbnail {
setup(data) { setup(data) {
/** /**
* The URL for this thumbnail * The URL for this thumbnail
* @type {String} * @type {string}
*/ */
this.url = data.url; this.url = data.url;
/** /**
* The Proxy URL for this thumbnail * The Proxy URL for this thumbnail
* @type {String} * @type {string}
*/ */
this.proxyURL = data.proxy_url; this.proxyURL = data.proxy_url;
/** /**
* The height of the thumbnail * The height of the thumbnail
* @type {Number} * @type {number}
*/ */
this.height = data.height; this.height = data.height;
/** /**
* The width of the thumbnail * The width of the thumbnail
* @type {Number} * @type {number}
*/ */
this.width = data.width; this.width = data.width;
} }
@@ -51,12 +51,12 @@ class MessageEmbedProvider {
setup(data) { setup(data) {
/** /**
* The name of this provider * The name of this provider
* @type {String} * @type {string}
*/ */
this.name = data.name; this.name = data.name;
/** /**
* The URL of this provider * The URL of this provider
* @type {String} * @type {string}
*/ */
this.url = data.url; this.url = data.url;
} }
@@ -83,22 +83,22 @@ class MessageEmbed {
setup(data) { setup(data) {
/** /**
* The title of this embed, if there is one * The title of this embed, if there is one
* @type {?String} * @type {?string}
*/ */
this.title = data.title; this.title = data.title;
/** /**
* The type of this embed * The type of this embed
* @type {String} * @type {string}
*/ */
this.type = data.type; this.type = data.type;
/** /**
* The description of this embed, if there is one * The description of this embed, if there is one
* @type {?String} * @type {?string}
*/ */
this.description = data.description; this.description = data.description;
/** /**
* The URL of this embed * The URL of this embed
* @type {String} * @type {string}
*/ */
this.url = data.url; this.url = data.url;
if (data.thumbnail) { if (data.thumbnail) {

8
src/structures/PartialGuild.js
View File

@@ -21,22 +21,22 @@ class PartialGuild {
setup(data) { setup(data) {
/** /**
* The hash of the guild splash image, or null if no splash (VIP only) * The hash of the guild splash image, or null if no splash (VIP only)
* @type {?String} * @type {?string}
*/ */
this.splash = data.splash; this.splash = data.splash;
/** /**
* The ID of this guild * The ID of this guild
* @type {String} * @type {string}
*/ */
this.id = data.id; this.id = data.id;
/** /**
* The hash of this guild's icon, or null if there is none. * The hash of this guild's icon, or null if there is none.
* @type {?String} * @type {?string}
*/ */
this.icon = data.icon; this.icon = data.icon;
/** /**
* The name of this guild * The name of this guild
* @type {String} * @type {string}
*/ */
this.name = data.name; this.name = data.name;
} }

6
src/structures/PartialGuildChannel.js
View File

@@ -20,17 +20,17 @@ class PartialGuildChannel {
setup(data) { setup(data) {
/** /**
* The ID of this Guild Channel * The ID of this Guild Channel
* @type {String} * @type {string}
*/ */
this.id = data.id; this.id = data.id;
/** /**
* The name of this Guild Channel * The name of this Guild Channel
* @type {String} * @type {string}
*/ */
this.name = data.name; this.name = data.name;
/** /**
* The type of this Guild Channel - `text` or `voice` * The type of this Guild Channel - `text` or `voice`
* @type {String} * @type {string}
*/ */
this.type = Constants.ChannelTypes.text === data.type ? 'text' : 'voice'; this.type = Constants.ChannelTypes.text === data.type ? 'text' : 'voice';
} }

4
src/structures/PermissionOverwrites.js
View File

@@ -16,12 +16,12 @@ class PermissionOverwrites {
setup(data) { setup(data) {
/** /**
* The type of this overwrite * The type of this overwrite
* @type {String} * @type {string}
*/ */
this.type = data.type; this.type = data.type;
/** /**
* The ID of this overwrite, either a User ID or a Role ID * The ID of this overwrite, either a User ID or a Role ID
* @type {String} * @type {string}
*/ */
this.id = data.id; this.id = data.id;
this.denyData = data.deny; this.denyData = data.deny;

36
src/structures/Role.js
View File

@@ -36,37 +36,37 @@ class Role {
setup(data) { setup(data) {
/** /**
* The ID of the role (unique to the guild it is part of) * The ID of the role (unique to the guild it is part of)
* @type {String} * @type {string}
*/ */
this.id = data.id; this.id = data.id;
/** /**
* The name of the role * The name of the role
* @type {String} * @type {string}
*/ */
this.name = data.name; this.name = data.name;
/** /**
* The base 10 color of the role * The base 10 color of the role
* @type {Number} * @type {number}
*/ */
this.color = data.color; this.color = data.color;
/** /**
* If true, users that are part of this role will appear in a separate category in the users list * If true, users that are part of this role will appear in a separate category in the users list
* @type {Boolean} * @type {boolean}
*/ */
this.hoist = data.hoist; this.hoist = data.hoist;
/** /**
* The position of the role in the role manager * The position of the role in the role manager
* @type {Number} * @type {number}
*/ */
this.position = data.position; this.position = data.position;
/** /**
* The evaluated permissions number * The evaluated permissions number
* @type {Number} * @type {number}
*/ */
this.permissions = data.permissions; this.permissions = data.permissions;
/** /**
* Whether or not the role is managed by an external service * Whether or not the role is managed by an external service
* @type {Boolean} * @type {boolean}
*/ */
this.managed = data.managed; this.managed = data.managed;
} }
@@ -100,7 +100,7 @@ class Role {
/** /**
* Set a new name for the role * Set a new name for the role
* @param {String} name the new name of the role * @param {string} name the new name of the role
* @returns {Promise<Role, Error>} * @returns {Promise<Role, Error>}
* @example * @example
* // set the name of the role * // set the name of the role
@@ -114,7 +114,7 @@ class Role {
/** /**
* Set a new color for the role * Set a new color for the role
* @param {Number|String} color the new color for the role, either a hex string or a base 10 number * @param {number|string} color the new color for the role, either a hex string or a base 10 number
* @returns {Promise<Role, Error>} * @returns {Promise<Role, Error>}
* @example * @example
* // set the color of a role * // set the color of a role
@@ -128,7 +128,7 @@ class Role {
/** /**
* Set whether or not the role should be hoisted * Set whether or not the role should be hoisted
* @param {Boolean} hoist whether or not to hoist the role * @param {boolean} hoist whether or not to hoist the role
* @returns {Promise<Role, Error>} * @returns {Promise<Role, Error>}
* @example * @example
* // set the hoist of the role * // set the hoist of the role
@@ -142,7 +142,7 @@ class Role {
/** /**
* Set the position of the role * Set the position of the role
* @param {Number} position the position of the role * @param {number} position the position of the role
* @returns {Promise<Role, Error>} * @returns {Promise<Role, Error>}
* @example * @example
* // set the position of the role * // set the position of the role
@@ -156,7 +156,7 @@ class Role {
/** /**
* Set the permissions of the role * Set the permissions of the role
* @param {Array<String>} permissions the permissions of the role * @param {Array<string>} permissions the permissions of the role
* @returns {Promise<Role, Error>} * @returns {Promise<Role, Error>}
* @example * @example
* // set the permissions of the role * // set the permissions of the role
@@ -170,7 +170,7 @@ class Role {
/** /**
* Get an object mapping permission names to whether or not the role enables that permission * Get an object mapping permission names to whether or not the role enables that permission
* @returns {Object<String, Boolean>} * @returns {Object<string, boolean>}
* @example * @example
* // print the serialized role * // print the serialized role
* console.log(role.serialize()); * console.log(role.serialize());
@@ -186,9 +186,9 @@ class Role {
/** /**
* Whether or not the role includes the given permission * Whether or not the role includes the given permission
* @param {String} permission the name of the permission to test * @param {string} permission the name of the permission to test
* @param {Boolean} [explicit=false] whether or not the inclusion of the permission is explicit * @param {boolean} [explicit=false] whether or not the inclusion of the permission is explicit
* @returns {Boolean} * @returns {boolean}
* @example * @example
* // see if a role can ban a member * // see if a role can ban a member
* if (role.hasPermission('BAN_MEMBERS')) { * if (role.hasPermission('BAN_MEMBERS')) {
@@ -217,7 +217,7 @@ class Role {
/** /**
* When concatenated with a String, this automatically concatenates the Role mention rather than the Role object. * When concatenated with a String, this automatically concatenates the Role mention rather than the Role object.
* @returns {String} * @returns {string}
*/ */
toString() { toString() {
return `<@&${this.id}>`; return `<@&${this.id}>`;
@@ -225,7 +225,7 @@ class Role {
/** /**
* The hexadecimal version of the role color, with a leading hashtag. * The hexadecimal version of the role color, with a leading hashtag.
* @type {String} * @type {string}
* @readonly * @readonly
*/ */
get hexColor() { get hexColor() {

2
src/structures/TextChannel.js
View File

@@ -18,7 +18,7 @@ class TextChannel extends GuildChannel {
super.setup(data); super.setup(data);
/** /**
* The ID of the last message in the channel, if one was sent. * The ID of the last message in the channel, if one was sent.
* @type {?String} * @type {?string}
*/ */
this.lastMessageID = data.last_message_id; this.lastMessageID = data.last_message_id;
this.type = 'text'; this.type = 'text';

20
src/structures/User.js
View File

@@ -16,27 +16,27 @@ class User {
setup(data) { setup(data) {
/** /**
* The username of the User * The username of the User
* @type {String} * @type {string}
*/ */
this.username = data.username; this.username = data.username;
/** /**
* The ID of the User * The ID of the User
* @type {String} * @type {string}
*/ */
this.id = data.id; this.id = data.id;
/** /**
* A discriminator based on username for the User * A discriminator based on username for the User
* @type {String} * @type {string}
*/ */
this.discriminator = data.discriminator; this.discriminator = data.discriminator;
/** /**
* The ID of the user's avatar * The ID of the user's avatar
* @type {String} * @type {string}
*/ */
this.avatar = data.avatar; this.avatar = data.avatar;
/** /**
* Whether or not the User is a Bot. * Whether or not the User is a Bot.
* @type {Boolean} * @type {boolean}
*/ */
this.bot = Boolean(data.bot); this.bot = Boolean(data.bot);
/** /**
@@ -45,19 +45,19 @@ class User {
* * **`online`** - user is online * * **`online`** - user is online
* * **`offline`** - user is offline * * **`offline`** - user is offline
* * **`idle`** - user is AFK * * **`idle`** - user is AFK
* @type {String} * @type {string}
*/ */
this.status = data.status || this.status || 'offline'; this.status = data.status || this.status || 'offline';
/** /**
* The game that the user is playing, `null` if they aren't playing a game. * The game that the user is playing, `null` if they aren't playing a game.
* @type {String} * @type {string}
*/ */
this.game = data.game || this.game; this.game = data.game || this.game;
} }
/** /**
* When concatenated with a String, this automatically concatenates the User's mention instead of the User object. * When concatenated with a String, this automatically concatenates the User's mention instead of the User object.
* @returns {String} * @returns {string}
* @example * @example
* // logs: Hello from <@123456789>! * // logs: Hello from <@123456789>!
* console.log(`Hello from ${user}!`); * console.log(`Hello from ${user}!`);
@@ -68,7 +68,7 @@ class User {
/** /**
* A link to the user's avatar (if they have one, otherwise null) * A link to the user's avatar (if they have one, otherwise null)
* @type {?String} * @type {?string}
* @readonly * @readonly
*/ */
get avatarURL() { get avatarURL() {
@@ -90,7 +90,7 @@ class User {
* Checks if the user is equal to another. It compares username, ID, discriminator, status and the game being played. * Checks if the user is equal to another. It compares username, ID, discriminator, status and the game being played.
* It is recommended to compare equality by using `user.id === user2.id` unless you want to compare all properties. * It is recommended to compare equality by using `user.id === user2.id` unless you want to compare all properties.
* @param {User} user the user to compare * @param {User} user the user to compare
* @returns {Boolean} * @returns {boolean}
*/ */
equals(user) { equals(user) {
let base = ( let base = (

10
src/structures/VoiceChannel.js
View File

@@ -10,7 +10,7 @@ class VoiceChannel extends GuildChannel {
super(guild, data); super(guild, data);
/** /**
* The members in this Voice Channel. * The members in this Voice Channel.
* @type {Collection<String, GuildMember>} * @type {Collection<string, GuildMember>}
*/ */
this.members = new Collection(); this.members = new Collection();
} }
@@ -19,12 +19,12 @@ class VoiceChannel extends GuildChannel {
super.setup(data); super.setup(data);
/** /**
* The bitrate of this voice channel * The bitrate of this voice channel
* @type {Number} * @type {number}
*/ */
this.bitrate = data.bitrate; this.bitrate = data.bitrate;
/** /**
* The maximum amount of users allowed in this channel - 0 means unlimited. * The maximum amount of users allowed in this channel - 0 means unlimited.
* @type {Number} * @type {number}
*/ */
this.userLimit = data.user_limit; this.userLimit = data.user_limit;
this.type = 'voice'; this.type = 'voice';
@@ -32,7 +32,7 @@ class VoiceChannel extends GuildChannel {
/** /**
* Sets the bitrate of the channel * Sets the bitrate of the channel
* @param {Number} bitrate the new bitrate * @param {number} bitrate the new bitrate
* @returns {Promise<VoiceChannel>} * @returns {Promise<VoiceChannel>}
* @example * @example
* // set the bitrate of a voice channel * // set the bitrate of a voice channel
@@ -59,7 +59,7 @@ class VoiceChannel extends GuildChannel {
/** /**
* Leaves this voice channel * Leaves this voice channel
* @returns {null} * @returns {void}
* @example * @example
* // leave a voice channel * // leave a voice channel
* voiceChannel.leave(); * voiceChannel.leave();

42
src/structures/interface/TextBasedChannel.js
View File

@@ -13,7 +13,7 @@ const EventEmitter = require('events').EventEmitter;
* return false; // failed the filter test * return false; // failed the filter test
* } * }
* ``` * ```
* @typedef {Function} CollectorFilterFunction * @typedef {function} CollectorFilterFunction
*/ */
/** /**
@@ -52,14 +52,14 @@ class MessageCollector extends EventEmitter {
this.options = options; this.options = options;
/** /**
* Whether this collector has stopped collecting Messages. * Whether this collector has stopped collecting Messages.
* @type {Boolean} * @type {boolean}
*/ */
this.ended = false; this.ended = false;
this.listener = (message => this.verify(message)); this.listener = (message => this.verify(message));
this.channel.client.on('message', this.listener); this.channel.client.on('message', this.listener);
/** /**
* A collection of collected messages, mapped by message ID. * A collection of collected messages, mapped by message ID.
* @type {Collection<String, Message>} * @type {Collection<string, Message>}
*/ */
this.collected = new Collection(); this.collected = new Collection();
if (options.time) { if (options.time) {
@@ -71,7 +71,7 @@ class MessageCollector extends EventEmitter {
* Verifies a message against the filter and options * Verifies a message against the filter and options
* @private * @private
* @param {Message} message * @param {Message} message
* @returns {Boolean} * @returns {boolean}
*/ */
verify(message) { verify(message) {
if (this.channel ? this.channel.id !== message.channel.id : false) { if (this.channel ? this.channel.id !== message.channel.id : false) {
@@ -109,10 +109,10 @@ class MessageCollector extends EventEmitter {
this.channel.client.removeListener('message', this.listener); this.channel.client.removeListener('message', this.listener);
/** /**
* Emitted when the Collector stops collecting. * Emitted when the Collector stops collecting.
* @param {Collection<String, Message>} collection A collection of messages collected * @param {Collection<string, Message>} collection A collection of messages collected
* during the lifetime of the Collector. * during the lifetime of the Collector.
* Mapped by the ID of the Messages. * Mapped by the ID of the Messages.
* @param {String} reason The reason for the end of the collector. If it ended because it reached the specified time * @param {string} reason The reason for the end of the collector. If it ended because it reached the specified time
* limit, this would be `time`. If you invoke `.stop()` without specifying a reason, this would be `user`. If it * limit, this would be `time`. If you invoke `.stop()` without specifying a reason, this would be `user`. If it
* ended because it reached its message limit, it will be `limit`. * ended because it reached its message limit, it will be `limit`.
* @event MessageCollector#end * @event MessageCollector#end
@@ -130,15 +130,15 @@ class TextBasedChannel {
constructor() { constructor() {
/** /**
* A Collection containing the messages sent to this channel. * A Collection containing the messages sent to this channel.
* @type {Collection<String, Message>} * @type {Collection<string, Message>}
*/ */
this.messages = new Collection(); this.messages = new Collection();
} }
/** /**
* Bulk delete a given Collection or Array of messages in one go. Returns the deleted messages after. * Bulk delete a given Collection or Array of messages in one go. Returns the deleted messages after.
* @param {Map<String, Message>|Array<Message>} messages the messages to delete * @param {Map<string, Message>|Array<Message>} messages the messages to delete
* @returns {Collection<String, Message>} * @returns {Collection<string, Message>}
*/ */
bulkDelete(messages) { bulkDelete(messages) {
if (messages instanceof Map) { if (messages instanceof Map) {
@@ -162,7 +162,7 @@ class TextBasedChannel {
*/ */
/** /**
* Send a message to this channel * Send a message to this channel
* @param {String} content the content to send * @param {string} content the content to send
* @param {MessageOptions} [options={}] the options to provide * @param {MessageOptions} [options={}] the options to provide
* @returns {Promise<Message>} * @returns {Promise<Message>}
* @example * @example
@@ -176,7 +176,7 @@ class TextBasedChannel {
} }
/** /**
* Send a text-to-speech message to this channel * Send a text-to-speech message to this channel
* @param {String} content the content to send * @param {string} content the content to send
* @param {MessageOptions} [options={}] the options to provide * @param {MessageOptions} [options={}] the options to provide
* @returns {Promise<Message>} * @returns {Promise<Message>}
* @example * @example
@@ -191,7 +191,7 @@ class TextBasedChannel {
/** /**
* Send a file to this channel * Send a file to this channel
* @param {FileResolvable} attachment The file to send * @param {FileResolvable} attachment The file to send
* @param {String} [fileName="file.jpg"] The name and extension of the file * @param {string} [fileName="file.jpg"] The name and extension of the file
* @returns {Promise<Message>} * @returns {Promise<Message>}
*/ */
sendFile(attachment, fileName) { sendFile(attachment, fileName) {
@@ -232,7 +232,7 @@ class TextBasedChannel {
/** /**
* Gets the past messages sent in this channel. Resolves with a Collection mapping message ID's to Message objects. * Gets the past messages sent in this channel. Resolves with a Collection mapping message ID's to Message objects.
* @param {ChannelLogsQueryOptions} [options={}] the query parameters to pass in * @param {ChannelLogsQueryOptions} [options={}] the query parameters to pass in
* @returns {Promise<Collection<String, Message>, Error>} * @returns {Promise<Collection<string, Message>, Error>}
* @example * @example
* // get messages * // get messages
* channel.fetchMessages({limit: 10}) * channel.fetchMessages({limit: 10})
@@ -257,8 +257,8 @@ class TextBasedChannel {
/** /**
* Starts a typing indicator in the channel. * Starts a typing indicator in the channel.
* @param {Number} [count] The number of times startTyping should be considered to have been called * @param {number} [count] The number of times startTyping should be considered to have been called
* @returns {null} * @returns {void}
* @example * @example
* // start typing in a channel * // start typing in a channel
* channel.startTyping(); * channel.startTyping();
@@ -283,8 +283,8 @@ class TextBasedChannel {
* Stops the typing indicator in the channel. * Stops the typing indicator in the channel.
* The indicator will only stop if this is called as many times as startTyping(). * The indicator will only stop if this is called as many times as startTyping().
* <info>It can take a few seconds for the Client User to stop typing.</info> * <info>It can take a few seconds for the Client User to stop typing.</info>
* @param {Boolean} [force=false] whether or not to force the indicator to stop regardless of call count * @param {boolean} [force=false] whether or not to force the indicator to stop regardless of call count
* @returns {null} * @returns {void}
* @example * @example
* // stop typing in a channel * // stop typing in a channel
* channel.stopTyping(); * channel.stopTyping();
@@ -305,7 +305,7 @@ class TextBasedChannel {
/** /**
* Whether or not the typing indicator is being shown in the channel. * Whether or not the typing indicator is being shown in the channel.
* @type {Boolean} * @type {boolean}
*/ */
get typing() { get typing() {
return this.client.user._typing.has(this.id); return this.client.user._typing.has(this.id);
@@ -313,7 +313,7 @@ class TextBasedChannel {
/** /**
* Number of times `startTyping` has been called. * Number of times `startTyping` has been called.
* @type {Number} * @type {number}
*/ */
get typingCount() { get typingCount() {
if (this.client.user._typing.has(this.id)) return this.client.user._typing.get(this.id).count; if (this.client.user._typing.has(this.id)) return this.client.user._typing.get(this.id).count;
@@ -354,7 +354,7 @@ class TextBasedChannel {
* filter. * filter.
* @param {CollectorFilterFunction} filter the filter function to use * @param {CollectorFilterFunction} filter the filter function to use
* @param {AwaitMessagesOptions} [options={}] optional options to pass to the internal collector * @param {AwaitMessagesOptions} [options={}] optional options to pass to the internal collector
* @returns {Promise<Collection<String, Message>>} * @returns {Promise<Collection<string, Message>>}
* @example * @example
* // await !vote messages * // await !vote messages
* const filter = m => m.content.startsWith('!vote'); * const filter = m => m.content.startsWith('!vote');
@@ -394,7 +394,7 @@ class TextBasedChannel {
/** /**
* Fetches the pinned messages of this Channel and returns a Collection of them. * Fetches the pinned messages of this Channel and returns a Collection of them.
* @returns {Promise<Collection<String, Message>, Error>} * @returns {Promise<Collection<string, Message>, Error>}
*/ */
fetchPinnedMessages() { fetchPinnedMessages() {
return new Promise((resolve, reject) => { return new Promise((resolve, reject) => {

18
src/util/Collection.js
View File

@@ -62,7 +62,7 @@ class Collection extends Map {
/** /**
* The length (size) of this collection. * The length (size) of this collection.
* @readonly * @readonly
* @type {Number} * @type {number}
*/ */
get length() { get length() {
return this.size; return this.size;
@@ -70,8 +70,8 @@ class Collection extends Map {
/** /**
* Returns an array of items where `item[key] === value` of the collection * Returns an array of items where `item[key] === value` of the collection
* @param {String} key the key to filter by * @param {string} key the key to filter by
* @param {any} value the expected value * @param {*} value the expected value
* @returns {Array<Object>} * @returns {Array<Object>}
* @example * @example
* collection.getAll('username', 'Bob'); * collection.getAll('username', 'Bob');
@@ -90,8 +90,8 @@ class Collection extends Map {
/** /**
* Returns a single item where `item[key] === value` * Returns a single item where `item[key] === value`
* @param {String} key the key to filter by * @param {string} key the key to filter by
* @param {any} value the expected value * @param {*} value the expected value
* @returns {Object} * @returns {Object}
* @example * @example
* collection.get('id', '123123...'); * collection.get('id', '123123...');
@@ -109,9 +109,9 @@ class Collection extends Map {
/** /**
* Returns true if the collection has an item where `item[key] === value` * Returns true if the collection has an item where `item[key] === value`
* @param {String} key the key to filter by * @param {string} key the key to filter by
* @param {any} value the expected value * @param {*} value the expected value
* @returns {Object} * @returns {boolean}
* @example * @example
* if (collection.exists('id', '123123...')) { * if (collection.exists('id', '123123...')) {
* console.log('user here!'); * console.log('user here!');
@@ -129,7 +129,7 @@ class Collection extends Map {
* Identical to * Identical to
* [Array.filter()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter), * [Array.filter()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter),
* but returns a Collection instead of an Array. * but returns a Collection instead of an Array.
* @param {Function} callback the callback used to filter * @param {function} callback the callback used to filter
* @param {Object} [thisArg] value to set as this when filtering * @param {Object} [thisArg] value to set as this when filtering
* @returns {Collection} * @returns {Collection}
*/ */