nodejs / nodejs/node

assert: add `expect()`

Open
#65,247 11 comments 4 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

assert feature request
Dominant language
JavaScript
Stars
122k
Forks
37.3k
Avg merge
4d 2h
Merged PRs (30d)
283

Description

What is the problem this feature will solve?

expect() is a popular way of writing assertions. From what I've been able to tell, many developers prefer writing assertions in this style compared to the current assertion style provided by node:assert. Many batteries included test runners (Jest, Vitest, bun:test, etc.) expose this API.

What is the feature you are proposing to solve the problem?

node:assert exports the expect() API.

What alternatives have you considered?

Use the existing node:assert assertions or install expect() from npm.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

The issue names no files, tests, or entry points. Start by reviewing the existing node:assert assertion API and the discussion around the proposed expect() API; done would require a defined, implemented, exported API with tests, but the issue does not specify its behavior or scope.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
testing
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.