How to Migrate My Discord.js Bot from v13 to v14?

Discord.js v14: Breaking Changes and Migration Guide

Introduction

The upgrade from Discord.js v13 to v14 introduces numerous breaking changes, some of which may impact existing code significantly. This article will guide you through the key changes and provide solutions to address any errors encountered during the migration.

Breaking Changes

1. Message and Interaction Events

• The message and interaction events have been removed.
• Use messageCreate and interactionCreate events instead.

2. Intents

• Intents have been updated to use the GatewayIntentBits enum.
• Replace string or number intents with the corresponding GatewayIntentBits flags.

3. Interactions

• Interaction type guards (e.g., isCommand, isMessageComponent) have been removed.
• Use comparisons against the InteractionType enum instead.

4. Channels

• Channel type guards (e.g., isDM, isText) have been removed.
• Compare channel.type to the matching ChannelType enum.

5. Builders and Embeds

• MessageEmbed has been renamed to EmbedBuilder.
• MessageAttachment uses an AttachmentData object as the second parameter instead of a name.
• MessageComponents have been renamed and require Builders with a Builder suffix (e.g., ButtonBuilder, ActionRowBuilder).

6. Enums

• All enum parameters now exclusively accept numbers.

7. Activity Types

• The setPresence activity type can only be set to "PLAYING."

8. Message Content

• If message.content is empty, add GatewayIntentBits.MessageContent to the intents array.

Migration Guide

To mitigate the breaking changes, consider the following steps:

• Update Node Version: Upgrade to Node 16.9 or higher.

• Update Intents:

  // v13
  client.on('GUILDS', 'GUILD_MESSAGES', 'GUILD_MESSAGE_REACTIONS');
  // v14
  client.on(GatewayIntentBits.Guilds, GatewayIntentBits.GuildMessages, GatewayIntentBits.GuildMessageReactions);

  Copy after login

• Refactor Interaction Guards:

  // v13
  if (interaction.isCommand()) {}
  // v14
  if (interaction.type === InteractionType.ApplicationCommand) {}

  Copy after login

• Update Type Guards for Channels:

  // v13
  if (message.channel.isText()) {}
  // v14
  if (channel.type === ChannelType.GuildText) {}

  Copy after login

• Rename Embeds and Builders:

  // v13
  const embed = new MessageEmbed();
  const button = new MessageButton();
  // v14
  const embed = new EmbedBuilder();
  const button = new ButtonBuilder();

  Copy after login

• Use Number-Based Constants:

  // v13
  new ButtonBuilder().setStyle('PRIMARY');
  // v14
  new ButtonBuilder().setStyle(ButtonStyle.Primary);

  Copy after login

By following these guidelines, you can successfully migrate your code to Discord.js v14 and avoid any potential errors or disruptions. For a comprehensive overview of the changes, refer to the Discord.js guide at https://discordjs.guide/additional-info/changes-in-v14.html.

The above is the detailed content of How to Migrate My Discord.js Bot from v13 to v14?. For more information, please follow other related articles on the PHP Chinese website!