Migration Guide
Node.js v20 is no longer supported
Node.js v20 and corresponding JavaScript runtimes are no longer supported. This is for use Promise.withResolvers and native WebSocket. Please upgrade to Node.js v22+ or ones that support ES2024+.
CJS is no longer supported
Until v7, Masto.js has supported both CJS and ESM, which was a big burden for the maintenance. Starting from v8, we have finally removed CJS support. We believe this is not a critical change even for CJS users because modern Node.js has a capability to require ESM module from CJS runtime. See --experimental-require-module for the details.
Rename mastodon.Admin to mastodon.admin
mastodon.Admin has been renamed to mastodon.admin. Now, every namespaces are consistently in lowercase.
Rename AccountCredentials to CredentialAccount
AccountCredentials has been renamed to CredentialAccount, which is the proper name for the resource used in the Mastodon codebase.
8.0.0 (2026-07-27)
⚠ BREAKING CHANGES
- Remove isomorphic-ws
- Rename AccountCredentials to CredentialAccount
- Drop CJS support
- Rename namespace Admin to admin for consistency
- Remove deprecated type aliases
- Use native Promise.withResolvers
Features
- Drop CJS support (0a3845e)
- Remove isomorphic-ws (b5b32ce)
- Use native Promise.withResolvers (a64675e)
Bug Fixes
- ci: Bump Node.js version for release-please action (#1444) (71ffa0e)
- Remove deprecated type aliases (4426bd0)
- Rename AccountCredentials to CredentialAccount (23c9e63)
Miscellaneous Chores
- Rename namespace Admin to admin for consistency (ce5f05d)