# @sapphire/discord.js-utilities

> Discord.js specific utilities for your JavaScript/TypeScript bots

Latest version **7.3.3** (published 2025-05-07) · MIT license · 0 weekly downloads

## Install

```sh
npm install @sapphire/discord.js-utilities
pnpm add @sapphire/discord.js-utilities
yarn add @sapphire/discord.js-utilities
bun add @sapphire/discord.js-utilities
```

## Health

**Score 50/100 (C)** — status: stable.

Positive: has types; esm support; no vulnerabilities; high maintenance score.

Warnings: low downloads.

Negative: stale.

## Facts

| | |
|---|---|
| Version | 7.3.3 |
| Published | 2025-05-07 |
| First published | 2021-01-01 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=16.6.0 |
| Dependencies | 4 |
| Unpacked size | 922.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 191 |
| Author | @sapphire |
| Maintainers | favna, vladfrangu, kyranet |
| Keywords | @sapphire/discord.js-utilities, bot, typescript, ts, yarn, discord, sapphire, standalone, discord.js |

## Links

- npm: https://www.npmjs.com/package/@sapphire/discord.js-utilities
- Repository: https://github.com/sapphiredev/utilities
- Homepage: https://github.com/sapphiredev/utilities/tree/main/packages/discord.js-utilities
- Issues: https://github.com/sapphiredev/utilities/issues
- npm.io page: https://npm.io/package/@sapphire/discord.js-utilities

## Dependencies (4)

- [tslib](https://npm.io/package/tslib.md) ^2.8.1
- [@sapphire/duration](https://npm.io/package/@sapphire/duration.md) ^1.2.0
- [@sapphire/utilities](https://npm.io/package/@sapphire/utilities.md) ^3.18.2
- [@sapphire/discord-utilities](https://npm.io/package/@sapphire/discord-utilities.md) ^3.5.0

## Alternatives

- [csv-to-markdown-table](https://npm.io/package/csv-to-markdown-table.md) — 47.0K weekly downloads
- [@sapphire/ratelimits](https://npm.io/package/@sapphire/ratelimits.md) — 4.4K weekly downloads
- [js-csvparser](https://npm.io/package/js-csvparser.md) — 2.0K weekly downloads
- [@adadapted/js-sdk](https://npm.io/package/@adadapted/js-sdk.md) — 251 weekly downloads
- [@grapecity/spread-sheets-sparklines](https://npm.io/package/@grapecity/spread-sheets-sparklines.md) — 103 weekly downloads

## Recent versions

- 7.3.3 (latest) — 2025-05-07
- 7.3.4-next.c1299bac (next) — 2026-03-08
- 8.0.0-pr-935.7da5c8bb (pr-935) — 2025-11-25
- 7.1.7-pr-725.55b1ff7b.0 (pr-725) — 2024-03-17
- 7.1.4-pr-684.9d7e2fce.0 (pr-684) — 2023-12-14
- 7.0.0-pr-601.2f2c308a.0 (pr-601) — 2023-05-28
- 7.0.0-pr-589.aa473f9.0 (pr-589) — 2023-05-04
- 7.0.0-pr-587.e9607661.0 (pr-587) — 2023-05-04
- 7.0.0-pr-584.b444d5b.0 (pr-584) — 2023-05-02
- 6.0.6-pr-575.91d23d87.0 (pr-575) — 2023-04-16
- 6.0.5-pr-567.8638d898.0 (pr-567) — 2023-04-06
- 5.2.0-pr-434.77ef153.0 (pr-434) — 2023-01-06
- 4.5.0-pr-270.b2c4518.0 (pr-270) — 2022-01-26
- 3.0.0-pr-160.676f855.0 (pr-160) — 2021-08-23
- 3.0.0-pr-159.fae7a606.0 (pr-159) — 2021-08-23
- … 1160 more at https://npm.io/package/@sapphire/discord.js-utilities/versions

## README

<div align="center">

![Sapphire Logo](https://raw.githubusercontent.com/sapphiredev/assets/main/banners/SapphireCommunity.png)

# @sapphire/discord.js-utilities

**Discord.js specific utilities for your JavaScript/TypeScript bots.**

[![GitHub](https://img.shields.io/github/license/sapphiredev/utilities)](https://github.com/sapphiredev/utilities/blob/main/LICENSE.md)
[![npm bundle size](https://img.shields.io/bundlephobia/min/@sapphire/discord.js-utilities?logo=webpack&style=flat-square)](https://bundlephobia.com/result?p=@sapphire/discord.js-utilities)
[![npm](https://img.shields.io/npm/v/@sapphire/discord.js-utilities?color=crimson&logo=npm&style=flat-square)](https://www.npmjs.com/package/@sapphire/discord.js-utilities)

</div>

## Description

There many functions that are always extremely useful to have when developing bots with [Discord.js]. Such as channel type guards, paged messages and more. For this purpose we provide @sapphire/discord.js-utilities. This is also an extension of sorts on our package [@sapphire/discord-utilities], which is agnostic to the API library you're using for your bot. That is to say, @sapphire/discord.js-utilities re-exports all functions from [@sapphire/discord-utilities]

## Features

-   Written in TypeScript.
-   Bundled with esbuild to provide size-optimal bundles.
-   Offers CommonJS and ESM bundles.

## Installation

`@sapphire/discord.js-utilities` depends on the following packages. Be sure to install these along with this package!

-   [`discord.js`](https://www.npmjs.com/package/discord.js)

You can use the following command to install this package, or replace `npm install` with your package manager of choice.

```sh
npm install @sapphire/discord.js-utilities discord.js
```

---

## Buy us some doughnuts

Sapphire Community is and always will be open source, even if we don't get donations. That being said, we know there are amazing people who may still want to donate just to show their appreciation. Thank you very much in advance!

We accept donations through Open Collective, Ko-fi, Paypal, Patreon and GitHub Sponsorships. You can use the buttons below to donate through your method of choice.

|   Donate With   |                       Address                       |
| :-------------: | :-------------------------------------------------: |
| Open Collective | [Click Here](https://sapphirejs.dev/opencollective) |
|      Ko-fi      |      [Click Here](https://sapphirejs.dev/kofi)      |
|     Patreon     |    [Click Here](https://sapphirejs.dev/patreon)     |
|     PayPal      |     [Click Here](https://sapphirejs.dev/paypal)     |

## Contributors

Please make sure to read the [Contributing Guide][contributing] before making a pull request.

Thank you to all the people who already contributed to Sapphire!

<a href="https://github.com/sapphiredev/utilities/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=sapphiredev/utilities" />
</a>

[contributing]: https://github.com/sapphiredev/.github/blob/main/.github/CONTRIBUTING.md
[@sapphire/discord-utilities]: https://www.npmjs.com/package/@sapphire/discord-utilities
[discord.js]: https://discordjs.dev

---
_Source: https://npm.io/package/@sapphire/discord.js-utilities · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
