@jest/globals
Advanced tools
Package description
The @jest/globals package provides access to Jest's global variables and functions, making it easier to write tests by providing a consistent testing environment. This package is particularly useful when working with ES modules, where Jest's globals are not automatically available. It includes functionalities such as test definition, mocking, and assertions.
Defining tests
Allows the definition of test cases. The `test` function is used to define a block of code that tests a specific part of your application. The `expect` function is used to make an assertion about a particular value.
import { test, expect } from '@jest/globals';
test('adds 1 + 2 to equal 3', () => {
expect(1 + 2).toBe(3);
});Mocking functions
Enables the mocking of functions, allowing you to simulate the behavior of your code's dependencies. This is useful for isolating the code under test and controlling its environment.
import { jest } from '@jest/globals';
const mockFn = jest.fn();
mockFn.mockReturnValue('mocked value');
expect(mockFn()).toBe('mocked value');Grouping tests
Provides a way to group related tests using the `describe` function. This helps in organizing tests, especially when testing complex applications.
import { describe, test, expect } from '@jest/globals';
describe('math operations', () => {
test('adds 1 + 2 to equal 3', () => {
expect(1 + 2).toBe(3);
});
test('subtracts 2 - 1 to equal 1', () => {
expect(2 - 1).toBe(1);
});
});Mocha is a feature-rich JavaScript test framework running on Node.js and in the browser, making asynchronous testing simple. It's similar to @jest/globals in providing a testing structure (describe and it blocks), but it requires additional libraries like Chai for assertions and Sinon for spies, mocks, and stubs.
Chai is a BDD / TDD assertion library for node and the browser that can be delightfully paired with any javascript testing framework. It's similar to the assertion part of @jest/globals, offering a range of assertions via expect, should, and assert interfaces. However, it does not provide test runner or mocking capabilities.
Sinon provides standalone test spies, stubs, and mocks for JavaScript. Works with any unit testing framework. It's similar to the mocking functionality of @jest/globals but is focused solely on the aspect of mocking, without an integrated test runner or assertion library.
Changelog
29.5.0
[jest-changed-files] Support Sapling (#13941)[jest-circus, @jest/cli, jest-config] Add feature to randomize order of tests via CLI flag or through the config file(#12922)[jest-cli, jest-config, @jest/core, jest-haste-map, @jest/reporters, jest-runner, jest-runtime, @jest/types] Add workerThreads configuration option to allow using worker threads for parallelization (#13939)[jest-cli] Export yargsOptions (#13970)[jest-config] Add openHandlesTimeout option to configure possible open handles warning. (#13875)[@jest/create-cache-key-function] Allow passing length argument to createCacheKey() function and set its default value to 16 on Windows (#13827)[jest-message-util] Add support for AggregateError (#13946 & #13947)[jest-message-util] Add support for Error causes in test and it (#13935 & #13966)[jest-reporters] Add summaryThreshold option to summary reporter to allow overriding the internal threshold that is used to print the summary of all failed tests when the number of test suites surpasses it (#13895)[jest-runtime] Expose @sinonjs/fake-timers async APIs functions advanceTimersByTimeAsync(msToRun) (tickAsync(msToRun)), advanceTimersToNextTimerAsync(steps) (nextAsync), runAllTimersAsync (runAllAsync), and runOnlyPendingTimersAsync (runToLastAsync) (#13981)[jest-runtime, @jest/transform] Allow V8 coverage provider to collect coverage from files which were not loaded explicitly (#13974)[jest-snapshot] Add support to cts and mts TypeScript files to inline snapshots (#13975)[jest-worker] Add start method to worker farms (#13937)[jest-worker] Support passing a URL as path to worker (#13982)[babel-plugin-jest-hoist] Fix unwanted hoisting of nested jest usages (#13952)[jest-circus] Send test case results for todo tests (#13915)[jest-circus] Update message printed on test timeout (#13830)[jest-circus] Avoid creating the word "testfalse" when takesDoneCallback is false in the message printed on test timeout AND updated timeouts test (#13954)[jest-environment-jsdom] Stop setting document to null on teardown (#13972)[@jest/expect-utils] Update toStrictEqual() to be able to check jest.fn().mock.calls (#13960)[@jest/test-result] Allow TestResultsProcessor type to return a Promise (#13950)[jest-snapshot] Remove dependency on jest-haste-map (#13977)FAQs
Unknown package
The npm package @jest/globals receives a total of 19,522,599 weekly downloads. As such, @jest/globals popularity was classified as popular.
We found that @jest/globals demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 3 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
NIST's new AI Risk Management Framework aims to enhance the security and reliability of generative AI systems and address the unique challenges of malicious AI exploits.
Security News
This episode of the Risky Biz podcast discusses how the rise of small open source packages and the shift towards individual maintainers makes the ecosystem more vulnerable to supply chain attacks.
Product
Streamline your login process and enhance security by enabling Single Sign-On (SSO) on the Socket platform, now available for all customers on the Enterprise plan, supporting 20+ identity providers.