If truthy, the test is expected to fail. If a non-empty string is provided, that string is displayed in the test results as the reason why the test is expected to fail. If a RegExp, Function, Object, or Error is provided directly (without wrapping in { match: … }), the test passes only if the thrown error matches, following the behavior of assert.throws. To provide both a reason and validation, pass an object with label (string) and match (RegExp, Function, Object, or Error).
property expectFailure | Node.js node:test module | Bun
Search the reference...
/
property
Resources
ReferenceDocsGuidesDiscordMerch StoreGitHubBlogToolkit
RuntimePackage managerTest runnerBundlerPackage runnerProject
Bun 1.0Bun 1.1Bun 1.2Bun 1.3RoadmapContributingLicenseBaked with ❤️ in San Francisco
We're hiring →property expectFailure | Node.js node:test module | Bun,AI智能索引,全网链接索引,智能导航,网页索引
- If truthy, the test is expected to fail. If a non-empty string is provided, that string is displayed
in the test results as the reason why the test is expected to fail. If a
`RegExp`, `Function`, `Object`, or `Error` is provided directly (without wrapping in `{ match: … }`), the test passes
only if the thrown error matches, following the behavior of
`assert.throws`. To provide both a reason and validation, pass an object
with `label` (string) and `match` (RegExp, Function, Object, or Error).