Discord.js v14の GatewayIntentBitsの定義になぜ{}を付けるのか

Question

前提

Discord.js(v14)でBotを作っています。
最初に

const { GatewayIntentBits } = require("discord.js")

と書く際に、なぜGatewayIntentBitsを{}で囲わなければいけないのかが調べてもよくわかりませんでした。

{}で囲わずに実行したときに出たエラーメッセージ

C:\DiscordBotProject\node_modules\discord.js\src\util\BitField.js:168
    throw new DiscordjsRangeError(ErrorCodes.BitFieldInvalid, bit);
    ^

RangeError [BitFieldInvalid]: Invalid bitfield flag or number: class BaseClient extends EventEmitter {
  constructor(options = {}) {
    super({ captureRejections: true });

    if (typeof options !== 'object' || options === null) {
      throw new DiscordjsTypeError(ErrorCodes.InvalidType, 'options', 'object', true);
    }

    /**
     * The options the client was instantiated with
     * @type {ClientOptions}
     */
    this.options = mergeDefault(Options.createDefault(), options);

    /**
     * The REST manager of the client
     * @type {REST}
     */
    this.rest = new REST(this.options.rest);
  }

  /**
   * Destroys all assets used by the base client.
   * @returns {void}
   */
  destroy() {
    this.rest.requestManager.clearHashSweeper();
    this.rest.requestManager.clearHandlerSweeper();
  }

  /**
   * Increments max listeners by one, if they are not zero.
   * @private
   */
  incrementMaxListeners() {
    const maxListeners = this.getMaxListeners();
    if (maxListeners !== 0) {
      this.setMaxListeners(maxListeners + 1);
    }
  }

  /**
   * Decrements max listeners by one, if they are not zero.
   * @private
   */
  decrementMaxListeners() {
    const maxListeners = this.getMaxListeners();
    if (maxListeners !== 0) {
      this.setMaxListeners(maxListeners - 1);
    }
  }

  toJSON(...props) {
    return flatten(this, ...props);
  }
}.
    at IntentsBitField.resolve (C:\DiscordBotProject\node_modules\discord.js\src\util\BitField.js:168:11)
    at C:\DiscordBotProject\node_modules\discord.js\src\util\BitField.js:163:54
    at Array.map (<anonymous>)
    at new BitField (C:\DiscordBotProject\node_modules\discord.js\src\util\BitField.js:33:38)
    at new IntentsBitField (C:\DiscordBotProject\node_modules\discord.js\src\util\IntentsBitField.js:9:1)
    at Client._validateOptions (C:\DiscordBotProject\node_modules\discord.js\src\client\Client.js:491:25)
    at new Client (C:\DiscordBotProject\node_modules\discord.js\src\client\Client.js:78:10)
    at Object.<anonymous> (C:\DiscordBotProject\index.js:13:16)
    at Module._compile (node:internal/modules/cjs/loader:1218:14) {
  code: 'BitFieldInvalid'
}

Node.js v18.13.0

該当のソースコード

const GatewayIntentBits = require("discord.js");

試したこと

検索

補足情報（FW/ツールのバージョンなど）

Node.js v18.13.0.
Discord.js v14.7.1

Answer 1

なぜGatewayIntentBitsを{}で囲わなければいけないのか

const { GatewayIntentBits } = require("discord.js")

これは 分割代入といって
require("discord.js")で読み込んだオブジェクトの中の、GatewayIntentBits を、変数 GatewayIntentBits に代入しています。

以下の処理と同等です：

const GatewayIntentBits = require("discord.js").GatewayIntentBits;

仮に

const GatewayIntentBits = require("discord.js")

としてしまうと、変数 GatewayIntentBits には discord.js が エクスポートしているオブジェクトがバインドされてしまうので、うまく動作しません。

なので最初のように

const { GatewayIntentBits } = require("discord.js")

とするか、
あるいは（冗長ですが）

const a = require("discord.js");
const GatewayIntentBits = a.GatewayIntentBits; 

とします。