Discord.js v13 TypeScript 向指定频道发消息send方法不存在报错如何解决？

错误原因 #

• client.channels.cache.get() 默认返回的是Channel基类类型，这是所有频道类型的通用父类，本身没有定义send方法，TypeScript静态类型检查会直接抛出属性不存在的错误。
• 你添加的运行时类型判断messageChannel.type === 'GUILD_TEXT'已经实际筛选出了具备send方法的文本频道实例，因此代码可以正常运行，但TypeScript默认没有针对该判断做自动类型收窄，因此智能提示仍然沿用基类的类型定义。

解决方案 #

方案1：临时类型断言 #

确认频道类型符合要求时，直接用as关键字做类型断言即可：

import { TextChannel } from 'discord.js';

// Define Channel ID
const messageChannelId = 'CHANNEL_ID';

// Define Channel
const messageChannel = client.channels.cache.get(messageChannelId);

// Send Message to Channel
if (messageChannel && messageChannel.type === 'GUILD_TEXT') {
  (messageChannel as TextChannel).send('Hello World');
}

方案2：自定义类型守卫 #

编写通用类型守卫函数，让TypeScript可以自动完成类型收窄，后续不需要重复写断言：

import { TextChannel, Channel } from 'discord.js';

function isGuildTextChannel(channel: Channel): channel is TextChannel {
  return channel.type === 'GUILD_TEXT';
}

// 业务代码
const messageChannel = client.channels.cache.get(messageChannelId);
if (messageChannel && isGuildTextChannel(messageChannel)) {
  // 此处TypeScript会自动识别messageChannel为TextChannel类型，调用send无报错
  messageChannel.send('Hello World');
}

方案3：拉取频道时直接指定类型 #

如果需要拉取非缓存的最新频道数据，也可以在fetch时直接标注类型：

import { TextChannel } from 'discord.js';

const messageChannel = await client.channels.fetch(messageChannelId) as TextChannel;
await messageChannel.send('Hello World');

内容的提问来源于stack exchange，提问作者Aircraft Overviewer