mirror of
https://github.com/discordjs/discord.js.git
synced 2026-03-10 00:23:30 +01:00
docs: mark getters as @ readonly
This commit is contained in:
@@ -34,6 +34,7 @@ class VoiceBroadcast extends EventEmitter {
|
||||
/**
|
||||
* The current master dispatcher, if any. This dispatcher controls all that is played by subscribed dispatchers.
|
||||
* @type {?BroadcastDispatcher}
|
||||
* @readonly
|
||||
*/
|
||||
get dispatcher() {
|
||||
return this.player.dispatcher;
|
||||
|
||||
@@ -130,6 +130,7 @@ class VoiceConnection extends EventEmitter {
|
||||
/**
|
||||
* The client that instantiated this connection
|
||||
* @type {Client}
|
||||
* @readonly
|
||||
*/
|
||||
get client() {
|
||||
return this.voiceManager.client;
|
||||
|
||||
@@ -146,12 +146,14 @@ class StreamDispatcher extends Writable {
|
||||
/**
|
||||
* Whether or not playback is paused
|
||||
* @type {boolean}
|
||||
* @readonly
|
||||
*/
|
||||
get paused() { return Boolean(this.pausedSince); }
|
||||
|
||||
/**
|
||||
* Total time that this dispatcher has been paused
|
||||
* @type {number}
|
||||
* @readonly
|
||||
*/
|
||||
get pausedTime() {
|
||||
return this._silentPausedTime + this._pausedTime + (this.paused ? Date.now() - this.pausedSince : 0);
|
||||
@@ -177,6 +179,7 @@ class StreamDispatcher extends Writable {
|
||||
/**
|
||||
* The time (in milliseconds) that the dispatcher has actually been playing audio for
|
||||
* @type {number}
|
||||
* @readonly
|
||||
*/
|
||||
get streamTime() {
|
||||
return this.count * FRAME_LENGTH;
|
||||
@@ -185,6 +188,7 @@ class StreamDispatcher extends Writable {
|
||||
/**
|
||||
* The time (in milliseconds) that the dispatcher has been playing audio for, taking into account skips and pauses
|
||||
* @type {number}
|
||||
* @readonly
|
||||
*/
|
||||
get totalStreamTime() {
|
||||
return Date.now() - this.startTime;
|
||||
@@ -322,6 +326,7 @@ class StreamDispatcher extends Writable {
|
||||
/**
|
||||
* Whether or not the Opus bitrate of this stream is editable
|
||||
* @type {boolean}
|
||||
* @readonly
|
||||
*/
|
||||
get bitrateEditable() { return this.streams.opus && this.streams.opus.setBitrate; }
|
||||
|
||||
|
||||
@@ -32,6 +32,7 @@ class VoiceWebSocket extends EventEmitter {
|
||||
/**
|
||||
* The client of this voice WebSocket
|
||||
* @type {Client}
|
||||
* @readonly
|
||||
*/
|
||||
get client() {
|
||||
return this.connection.voiceManager.client;
|
||||
|
||||
@@ -15,6 +15,7 @@ class VolumeInterface extends EventEmitter {
|
||||
/**
|
||||
* Whether or not the volume of this stream is editable
|
||||
* @type {boolean}
|
||||
* @readonly
|
||||
*/
|
||||
get volumeEditable() {
|
||||
return true;
|
||||
@@ -22,8 +23,8 @@ class VolumeInterface extends EventEmitter {
|
||||
|
||||
/**
|
||||
* The current volume of the stream
|
||||
* @readonly
|
||||
* @type {number}
|
||||
* @readonly
|
||||
*/
|
||||
get volume() {
|
||||
return this._volume;
|
||||
@@ -31,8 +32,8 @@ class VolumeInterface extends EventEmitter {
|
||||
|
||||
/**
|
||||
* The current volume of the stream in decibels
|
||||
* @readonly
|
||||
* @type {number}
|
||||
* @readonly
|
||||
*/
|
||||
get volumeDecibels() {
|
||||
return Math.log10(this.volume) * 20;
|
||||
@@ -40,8 +41,8 @@ class VolumeInterface extends EventEmitter {
|
||||
|
||||
/**
|
||||
* The current volume of the stream from a logarithmic scale
|
||||
* @readonly
|
||||
* @type {number}
|
||||
* @readonly
|
||||
*/
|
||||
get volumeLogarithmic() {
|
||||
return Math.pow(this.volume, 1 / 1.660964);
|
||||
|
||||
@@ -20,6 +20,7 @@ class GuildEmojiRoleStore extends Collection {
|
||||
* The filtered collection of roles of the guild emoji
|
||||
* @type {Collection<Snowflake, Role>}
|
||||
* @private
|
||||
* @readonly
|
||||
*/
|
||||
get _filtered() {
|
||||
return this.guild.roles.filter(role => this.emoji._roles.includes(role.id));
|
||||
|
||||
@@ -20,6 +20,7 @@ class GuildMemberRoleStore extends Collection {
|
||||
* The filtered collection of roles of the member
|
||||
* @type {Collection<Snowflake, Role>}
|
||||
* @private
|
||||
* @readonly
|
||||
*/
|
||||
get _filtered() {
|
||||
const everyone = this.guild.defaultRole;
|
||||
|
||||
@@ -30,8 +30,8 @@ class ClientUser extends Structures.get('User') {
|
||||
|
||||
/**
|
||||
* ClientUser's presence
|
||||
* @readonly
|
||||
* @type {Presence}
|
||||
* @readonly
|
||||
*/
|
||||
get presence() {
|
||||
return this.client.presence;
|
||||
|
||||
@@ -49,6 +49,7 @@ class DMChannel extends Channel {
|
||||
/**
|
||||
* Whether this DMChannel is a partial
|
||||
* @type {boolean}
|
||||
* @readonly
|
||||
*/
|
||||
get partial() {
|
||||
return !this.recipient;
|
||||
|
||||
@@ -83,6 +83,7 @@ class GuildMember extends Base {
|
||||
/**
|
||||
* Whether this GuildMember is a partial
|
||||
* @type {boolean}
|
||||
* @readonly
|
||||
*/
|
||||
get partial() {
|
||||
return !this.joinedTimestamp;
|
||||
|
||||
@@ -172,6 +172,7 @@ class Message extends Base {
|
||||
/**
|
||||
* Whether or not this message is a partial
|
||||
* @type {boolean}
|
||||
* @readonly
|
||||
*/
|
||||
get partial() {
|
||||
return typeof this.content !== 'string' || !this.author;
|
||||
|
||||
@@ -45,6 +45,7 @@ class Presence {
|
||||
/**
|
||||
* The user of this presence
|
||||
* @type {?User}
|
||||
* @readonly
|
||||
*/
|
||||
get user() {
|
||||
return this.client.users.get(this.userID) || null;
|
||||
@@ -53,6 +54,7 @@ class Presence {
|
||||
/**
|
||||
* The member of this presence
|
||||
* @type {?GuildMember}
|
||||
* @readonly
|
||||
*/
|
||||
get member() {
|
||||
return this.guild.members.get(this.userID) || null;
|
||||
|
||||
@@ -78,6 +78,7 @@ class User extends Base {
|
||||
/**
|
||||
* Whether this User is a partial
|
||||
* @type {boolean}
|
||||
* @readonly
|
||||
*/
|
||||
get partial() {
|
||||
return typeof this.username !== 'string';
|
||||
|
||||
@@ -30,6 +30,7 @@ class VoiceChannel extends GuildChannel {
|
||||
* The members in this voice channel
|
||||
* @type {Collection<Snowflake, GuildMember>}
|
||||
* @name VoiceChannel#members
|
||||
* @readonly
|
||||
*/
|
||||
get members() {
|
||||
const coll = new Collection();
|
||||
|
||||
@@ -58,6 +58,7 @@ class VoiceState extends Base {
|
||||
/**
|
||||
* The member that this voice state belongs to
|
||||
* @type {?GuildMember}
|
||||
* @readonly
|
||||
*/
|
||||
get member() {
|
||||
return this.guild.members.get(this.id) || null;
|
||||
@@ -66,6 +67,7 @@ class VoiceState extends Base {
|
||||
/**
|
||||
* The channel that the member is connected to
|
||||
* @type {?VoiceChannel}
|
||||
* @readonly
|
||||
*/
|
||||
get channel() {
|
||||
return this.guild.channels.get(this.channelID) || null;
|
||||
@@ -74,6 +76,7 @@ class VoiceState extends Base {
|
||||
/**
|
||||
* Whether this member is either self-deafened or server-deafened
|
||||
* @type {?boolean}
|
||||
* @readonly
|
||||
*/
|
||||
get deaf() {
|
||||
return this.serverDeaf || this.selfDeaf;
|
||||
@@ -82,6 +85,7 @@ class VoiceState extends Base {
|
||||
/**
|
||||
* Whether this member is either self-muted or server-muted
|
||||
* @type {?boolean}
|
||||
* @readonly
|
||||
*/
|
||||
get mute() {
|
||||
return this.serverMute || this.selfMute;
|
||||
@@ -91,6 +95,7 @@ class VoiceState extends Base {
|
||||
* Whether this member is currently speaking. A boolean if the information is available (aka
|
||||
* the bot is connected to any voice channel in the guild), otherwise this is null
|
||||
* @type {?boolean}
|
||||
* @readonly
|
||||
*/
|
||||
get speaking() {
|
||||
return this.channel && this.channel.connection ?
|
||||
|
||||
Reference in New Issue
Block a user