# 이벤트 핸들링

Node.js는 이벤트 기반 설계를 통해 특정 이벤트가 일어나면 특정 코드를 실행할 수 있게 합니다. discord.js 라이브러리는 이를 완전히 활용합니다. Clientopen in new window docs에서 모든 이벤트의 리스트를 볼 수 있어요.

아래 코드를 기본으로 시작합니다:

const { Client, Intents } = require('discord.js');
const { token } = require('./config.json');

const client = new Client({ intents: [Intents.FLAGS.GUILDS] });

client.once('ready', c => {
	console.log(`준비 완료!${c.user.tag}로 로그인했어요.`);
});

client.on('interactionCreate', interaction => {
	console.log(`${interaction.user.tag} in #${interaction.channel.name} 가 상호작용을 실행했어요.`);
});

client.login(token);

지금 모든 이벤트 리스너는 index.js 파일에 있어요. Client를 사용할 준비가 되었을 때 (로그인되었을 때) Client#event:readyopen in new window가 실행되고, 상호작용을 받으면 Client#event:interactionCreateopen in new window가 실행돼요. 이벤트 리스너를 각각의 파일로 옮기는 것은 쉽고, 명령어 핸들링과 비슷한 방법을 사용할 거에요.

# 각 이벤트별 파일

프로젝트 폴더는 이런식으로 되어 있을 거에요:

discord-bot/
├── node_modules
├── config.json
├── index.js
├── package-lock.json
└── package.json

events 폴더를 같은 폴더에 만드세요. 그러면 index.js에 있는 이벤트 리스너를 events/ready.js와 events/interactionCreate.js 파일로 옮길 수 있어요.

module.exports = {
	name: 'ready',
	once: true,
	execute(client) {
		console.log(`준비 완료! ${client.user.tag}로 로그인했어요.`);
	},
};

module.exports = {
	name: 'interactionCreate',
	execute(interaction) {
		console.log(`${interaction.user.tag} 가 #${interaction.channel.name}에서 상호작용을 실행했어요.`);
	},
};

name 속성은 이 파일이 어떤 이벤트에 대한 것인지를 나타내고,once 속성은 이 코드를 한 번만 실행할 지 나타내요. execute 함수는 해당 이벤트가 일어날 때마다 실행할 코드에요.

# 이벤트 파일 읽기

다음으로, events 폴더에서 파일을 동적으로 가져오는 코드를 작성합니다. 명령어 핸들링과 비슷한 방법을 사용합니다.

fs.readdirSync().filter() 는 지정한 폴더 안에 있는 모든 파일 이름으로 이루어진 배열을 리턴하고 .js 파일만 남깁니다. (예시: ['ready.js', 'interactionCreate.js'])

const client = new Client({ intents: [Intents.FLAGS.GUILDS] });

const eventFiles = fs.readdirSync('./events').filter(file => file.endsWith('.js'));

for (const file of eventFiles) {
	const event = require(`./events/${file}`);
	if (event.once) {
		client.once(event.name, (...args) => event.execute(...args));
	} else {
		client.on(event.name, (...args) => event.execute(...args));
	}
}

discord.js의 Clientopen in new window 클래스는 EventEmitteropen in new window 클래스를 확장합니다. 그러므로 client 객체는 이벤트 리스너를 등록하는 데 사용할 수 있는 .on()open in new window과 .once()open in new window 함수를 노출합니다. 이 두 함수는 2개의 파라미터를 갖는데, 첫 번째는 이벤트 이름, 두 번째는 실행할 코드의 콜백 함수입니다.

콜백 함수는 해당 이벤트에서 주어진 파라미터를 가져와서, ... rest parameter syntaxopen in new window로 args에 모은 다음, event.execute()를 실행하며, 이때 ... spread syntaxopen in new window를 통해 args 배열을 파라미터로 넘깁니다. discord.js의 서로 다른 이벤트가 서로 다른 개수의 파라미터를 가지고 있기 때문에 rest parameter syntax와 spread syntax를 사용합니다. rest parameter는 정해지지 않은 개수의 모든 파라미터를 배열 하나로 모으며 spread syntax는 이 배열의 각 항목을 따로따로 execute 함수에 넘깁니다.

이제 다른 이벤트에 대한 리스너를 만드는 것은 events 폴더에 새 파일을 만들기만 하면 돼요. 이벤트 핸들러는 봇을 시작할 때마다 자동으로 새 파일을 가져와서 실행하게 돼요.

# 결과 코드

지금까지 만들어온 코드를 비교해보고 싶으시다면, 이 깃헙 리포지토리 open in new window 에서 확인하실 수 있습니다.