Migrating from Discord.js v11 to v12: Resolving Common Issues

When upgrading to Discord.js v12, you may encounter errors due to breaking changes. Here are some common issues and their solutions:

Managers

• client.users.get and Guild#roles.find have been replaced by client.users.cache.get and guild.roles.cache.find, respectively.

• Methods like message.member.addRole, Guild#createChannel, and TextBasedChannel#fetchMessages have been moved to their respective managers. For example:

  await message.member.roles.add(role);
  await message.guild.channels.create('welcome');
  const messages = await message.channel.messages.fetch();

Collection

• Collection class now only accepts functions for .find and .findKey. Use lambda expressions instead of property keys and values. For example:

  collection.find(item => item.property === 'value');

• .exists, .deleteAll, .filterArray, .findAll have been removed. Use alternative methods or await promises instead.

RichEmbed/MessageEmbed

• RichEmbed has been replaced by MessageEmbed, which is used for both received and sent embeds.

• addBlankField method has been removed. To add a blank field, use:

  embed.addField('\u200B', '\u200B');

Voice

• All VoiceConnection/VoiceBroadcast#play*** methods have been unified under a single play method. For example:

  const dispatcher = connection.play('./music.mp3');

• Client#createVoiceBroadcast has been moved to ClientVoiceManager.
• StreamDispatcher extends stream.Writable. Use dispatcher.destroy() instead of dispatcher.end(). The end event has been removed in favor of finish.

Image URLs

• User#displayAvatarURL and Guild#iconURL are now methods. They require passing an ImageURLOptions object for customization:

  const avatar = user.displayAvatarURL();
  const icon = mesage.guild.iconURL();

Additional Information

For a comprehensive guide to v12 breaking changes, refer to the official updating guide and changelog. The Discord.js documentation can help you find specific methods and properties.