jest-environment-jsdom
Advanced tools
Package description
The jest-environment-jsdom package is a custom environment for Jest that allows you to simulate a browser-like environment using jsdom. This is useful for testing web applications without running them in an actual browser. It provides a simulated DOM API that you can interact with in your tests.
Simulating browser environment for testing
This feature allows you to simulate browser-like interactions such as clicking a button and then asserting the expected outcome, all within a Node.js environment.
test('simulates a click event', () => {
document.body.innerHTML = '<button id="button">Click me</button>';
const button = document.getElementById('button');
button.addEventListener('click', () => {
button.innerHTML = 'Clicked';
});
button.click();
expect(button.innerHTML).toBe('Clicked');
});Testing DOM manipulation
You can test DOM manipulation by creating, modifying, and removing elements, and then asserting that these changes have taken place as expected.
test('adds a new div to the body', () => {
const div = document.createElement('div');
div.id = 'new-div';
document.body.appendChild(div);
expect(document.getElementById('new-div')).not.toBeNull();
});Mocking global variables
The package allows you to mock global variables such as localStorage, which is useful for testing code that interacts with browser APIs that are not available in Node.js.
test('mocks a global variable', () => {
global.localStorage = {
getItem: jest.fn().mockReturnValue('mockValue')
};
expect(global.localStorage.getItem('key')).toBe('mockValue');
});This package is similar to jest-environment-jsdom but is intended for testing Node.js applications. It does not simulate a browser environment and is therefore not suitable for testing browser-specific code.
Karma is a test runner that works with any framework and allows you to run tests in real browsers. Unlike jest-environment-jsdom, which simulates a browser environment, Karma actually runs tests in real browsers, which can be more accurate but also slower and more complex to set up.
This package integrates jsdom with Mocha, another testing framework. It provides similar functionality to jest-environment-jsdom but is designed to work with Mocha instead of Jest.
Enzyme is a testing utility for React that makes it easier to assert, manipulate, and traverse your React Components' output. It can be used in conjunction with jest-environment-jsdom to test React components in a simulated browser environment.
Changelog
29.0.0
[expect] [BREAKING] Differentiate between MatcherContext MatcherUtils and MatcherState types (#13141)[jest-circus] Add support for test.failing.each (#13142)[jest-config] [BREAKING] Make snapshotFormat default to escapeString: false and printBasicPrototype: false (#13036)[jest-config] [BREAKING] Remove undocumented collectCoverageOnlyFrom option (#13156)[jest-environment-jsdom] [BREAKING] Upgrade to jsdom@20 (#13037, #13058)[@jest/globals] Add jest.Mocked, jest.MockedClass, jest.MockedFunction and jest.MockedObject utility types (#12727)[jest-mock] [BREAKING] Refactor Mocked* utility types. MaybeMockedDeep and MaybeMocked became Mocked and MockedShallow respectively; only deep mocked variants of MockedClass, MockedFunction and MockedObject are exported (#13123, #13124)[jest-mock] [BREAKING] Change the default jest.mocked helper’s behavior to deep mocked (#13125)[jest-snapshot] [BREAKING] Let babel find config when updating inline snapshots (#13150)[@jest/test-result, @jest/types] [BREAKING] Replace Bytes and Milliseconds types with number (#13155)[jest-worker] Adds workerIdleMemoryLimit option which is used as a check for worker memory leaks >= Node 16.11.0 and recycles child workers as required (#13056, #13105, #13106, #13107)[pretty-format] [BREAKING] Remove ConvertAnsi plugin in favour of jest-serializer-ansi-escapes (#13040)[pretty-format] Allow to opt out from sorting object keys with compareKeys: null (#12443)[jest-config] Fix testing multiple projects with TypeScript config files (#13099)[@jest/expect-utils] Fix deep equality of ImmutableJS Record (#13055)[jest-haste-map] Increase the maximum possible file size that jest-haste-map can handle (#13094)[jest-runtime] Properly support CJS re-exports from dual packages (#13170)[jest-snapshot] Make prettierPath optional in SnapshotState (#13149)[jest-snapshot] Fix parsing error from inline snapshot files with JSX (#12760)[jest-worker] When a process runs out of memory worker exits correctly and doesn't spin indefinitely (#13054)[*] [BREAKING] Drop support for Node v12 and v17 (#13033)[docs] Fix webpack name (#13049)[docs] Explicit how to set n for --bail (#13128)[docs] Update Enzyme URL (#13166)[jest-leak-detector] Remove support for weak-napi (#13035)[jest-snapshot] [BREAKING] Require rootDir as argument to SnapshotState (#13150)FAQs
Unknown package
We found that jest-environment-jsdom 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
CISA launched a new project called Vulnrichment to enrich CVEs with details that help prioritize patching and mitigation efforts, as the NVD backlog of unenriched CVEs awaiting analysis surpasses 10,000.
Security News
Socket is joining forces with CISA and other industry leaders at the RSA Conference to sign the Secure by Design pledge, committing to uphold the highest security standards in our products.
Research
The Socket research team breaks down a sampling of malicious packages that download and execute files, among other suspicious behaviors, targeting the popular Discord platform.