A simple, promise-based Discord webhook sender for Node.js with built-in rate limit handling.
- Send messages to Discord webhooks with a single function
- Handles Discord rate limits automatically (HTTP 429)
- ESM-first, TypeScript types included
- Customizable fetch for testing/mocking
- Supports default webhook URL from
process.env.DISCORD_WEBHOOK
npm install @eliware/discord-webhookimport { sendMessage } from '@eliware/discord-webhook';
const webhookUrl = 'https://discord.com/api/webhooks/your-webhook-id/your-webhook-token';
const messageBody = { content: 'Hello from discord-webhook!' };
(async () => {
try {
const response = await sendMessage({ url: webhookUrl, body: messageBody });
if (response.ok) {
console.log('Message sent successfully!');
} else {
console.error('Failed to send message:', response.status, await response.text());
}
} catch (err) {
console.error('Error sending message:', err);
}
})();Sends a message to a Discord webhook URL, handling rate limits with automatic retry.
Parameters:
body(object): The JSON body to send (e.g.,{ content: 'Hello!' }).url(string, optional): The Discord webhook URL. Defaults toprocess.env.DISCORD_WEBHOOK.maxRetries(number, optional): Maximum number of retries on rate limit (default: 3).fetchFn(function, optional): Custom fetch function for testing/mocking (default:fetch).
Returns:
Promise<Response>: The fetch response.
Throws:
- Error if the URL or body is invalid, or if max retries are exceeded due to rate limiting.
Type definitions are included:
export declare function sendMessage(params?: {
body: object;
url?: string;
maxRetries?: number;
fetchFn?: typeof fetch;
}): Promise<Response>;For help, questions, or to chat with the author and community, visit:
