[ { "path": ".babelrc", "content": "{\n \"presets\": [\"airbnb\"],\n \"plugins\": [\n [\"transform-replace-object-assign\", { \"moduleSpecifier\": \"object.assign\" }],\n [\"add-module-exports\"],\n ],\n \"ignore\": [\n \"packages/enzyme-test-suite/test/_helpers/untranspiled*\",\n ],\n \"sourceMaps\": \"both\",\n}\n" }, { "path": ".eslintrc", "content": "{\n \"extends\": \"airbnb\",\n \"root\": true,\n \"env\": {\n \"node\": true,\n },\n \"parser\": \"@babel/eslint-parser\",\n \"ignorePatterns\": [\n \"/build\",\n \"_book\",\n \"packages/*/build/\",\n // Temporarily copied\n \"packages/*/LICENSE.md\",\n \"packages/enzyme/README.md\",\n \"packages/enzyme-adapter-react-*/README.md\",\n \"packages/enzyme-adapter-utils*/README.md\",\n ],\n \"rules\": {\n \"id-length\": 0,\n \"react/no-find-dom-node\": 1,\n \"import/first\": 0,\n \"max-len\": 0,\n },\n \"overrides\": [\n { // things that run in older envs, without babel\n \"files\": [\n \"env.js\",\n \"karma.conf.js\",\n \"since.js\",\n ],\n \"rules\": {\n \"import/no-extraneous-dependencies\": [2, {\n \"devDependencies\": true,\n }],\n \"comma-dangle\": [2, {\n \"arrays\": \"always-multiline\",\n \"objects\": \"always-multiline\",\n \"imports\": \"always-multiline\",\n \"exports\": \"always-multiline\",\n \"functions\": \"ignore\",\n }],\n \"strict\": [2, \"safe\"],\n \"prefer-destructuring\": 0,\n \"prefer-template\": 0,\n },\n \"parserOptions\": {\n \"sourceType\": \"script\",\n },\n },\n {\n \"files\": [\n \"**/*.md\",\n \"**/*.md/**\"\n ],\n \"extends\": [\"plugin:markdown/recommended\"],\n \"rules\": {\n \"class-methods-use-this\": 0,\n \"import/extensions\": 0,\n \"import/no-extraneous-dependencies\": 0,\n \"import/no-unresolved\": 0,\n \"import/prefer-default-export\": 0,\n \"max-len\": 0,\n \"no-console\": 0,\n \"no-undef\": 0,\n \"no-unused-vars\": 0,\n \"react/jsx-filename-extension\": 0,\n \"react/jsx-fragments\": 0,\n \"react/jsx-no-undef\": 0,\n \"react/jsx-no-useless-fragment\": 0,\n \"react/jsx-one-expression-per-line\": 0,\n \"react/no-multi-comp\": 0,\n \"react/no-unknown-property\": 0,\n \"react/no-unused-class-component-methods\": 0,\n \"react/react-in-jsx-scope\": 0,\n },\n },\n ],\n}\n" }, { "path": ".github/FUNDING.yml", "content": "# These are supported funding model platforms\n\ngithub: [ljharb]\npatreon: # Replace with a single Patreon username\nopen_collective: # Replace with a single Open Collective username\nko_fi: # Replace with a single Ko-fi username\ntidelift: npm/enzyme\ncommunity_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry\nliberapay: # Replace with a single Liberapay username\nissuehunt: # Replace with a single IssueHunt username\notechie: # Replace with a single Otechie username\ncustom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']\n" }, { "path": ".github/ISSUE_TEMPLATE/Bug_report.md", "content": "---\nname: 🐛 Bug report\nabout: Create a report to help us improve\n\n---\nThanks for reporting an issue to us! We're glad you are using and invested in Enzyme.\nBefore submitting, please read over our commonly reported issues to prevent duplicates!\n\n### All common issues\n\n* [common issues](../blob/master/docs/common-issues.md)\n\n### Notoriously common issues\n\n* [Webpack build issues](../blob/master/docs/common-issues.md#webpack-build-issues)\n* [Cannot find module 'react-dom/lib/ReactTestUtils'](../blob/master/docs/common-issues.md#error-cannot-find-module-react-domlibreacttestutils)\n* [Query Selector fails](../blob/master/docs/common-issues.md#query-selector-fails)\n* [Testing third party libraries](../blob/master/docs/common-issues.md#testing-third-party-libraries)\n\nIf you haven't found any duplicated issues, please report it with your environment!\n\n### Current behavior\n\n### Expected behavior\n\n### Your environment\n\n#### API\n\n- [ ] shallow\n- [ ] mount\n- [ ] render\n\n#### Version\n\n| library | version\n| ------------------- | -------\n| enzyme | \n| react | \n| react-dom | \n| react-test-renderer | \n| adapter (below) | \n\n#### Adapter\n\n- [ ] enzyme-adapter-react-16\n- [ ] enzyme-adapter-react-16.3\n- [ ] enzyme-adapter-react-16.2\n- [ ] enzyme-adapter-react-16.1\n- [ ] enzyme-adapter-react-15\n- [ ] enzyme-adapter-react-15.4\n- [ ] enzyme-adapter-react-14\n- [ ] enzyme-adapter-react-13\n- [ ] enzyme-adapter-react-helper\n- [ ] others ( ) \n" }, { "path": ".github/ISSUE_TEMPLATE/Feature_request.md", "content": "---\nname: 🙏 Feature request\nabout: Suggest an idea for this project\n\n---\n\n**Is your feature request related to a problem? Please describe.**\nA clear and concise description of what the problem is. e.g. I'm always frustrated when [...]\n\n**Describe the solution you'd like**\nA clear and concise description of what you want to happen.\n\n**Describe alternatives you've considered**\nA clear and concise description of any alternative solutions or features you've considered.\n\n**Additional context**\nAdd any other context or screenshots about the feature request here.\n" }, { "path": ".github/workflows/node-pretest.yml", "content": "name: 'Tests: pretest/posttest'\n\non: [pull_request, push]\n\njobs:\n pretest:\n runs-on: ubuntu-latest\n\n steps:\n - uses: actions/checkout@v3\n - uses: ljharb/actions/node/install@main\n with:\n skip-ls-check: true\n - run: sh install-relevant-react.sh\n - run: npx lerna bootstrap\n - run: npm run build\n - run: npm run pretest\n\n # posttest:\n # runs-on: ubuntu-latest\n\n # steps:\n # - uses: actions/checkout@v3\n # - uses: ljharb/actions/node/install@main\n # - run: npm run build\n # - run: npm run posttest\n" }, { "path": ".github/workflows/node.yml", "content": "name: 'Tests: node.js'\n\non: [pull_request, push]\n\njobs:\n build:\n name: 'install deps and build'\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v3\n - uses: ljharb/actions/node/install@main\n with:\n skip-ls-check: true\n - run: npx lerna bootstrap\n - run: npm run build\n - uses: actions/cache@v3\n with:\n path: |\n packages/*/build\n node_modules\n packages/*/node_modules\n key: enzyme-${{ github.workflow }}-${{ github.action }}-${{ github.run_id }}\n\n karma-matrix:\n needs: [build]\n name: 'karma tests'\n runs-on: ubuntu-latest\n continue-on-error: true\n strategy:\n fail-fast: false\n matrix:\n react:\n - '16'\n - '16.3'\n - '16.2'\n - '16.1'\n - '15'\n - '15.4'\n - '0.14'\n - '0.13'\n steps:\n - uses: actions/checkout@v3\n - uses: actions/cache@v3\n with:\n path: |\n packages/*/build\n node_modules\n packages/*/node_modules\n key: enzyme-${{ github.workflow }}-${{ github.action }}-${{ github.run_id }}\n - run: sudo chmod -R a+w .\n - uses: ljharb/actions/node/install@main\n with:\n node-version: 'lts/*'\n skip-install: true\n after_install: '(nvm install node && REACT=${{ matrix.react }} TRAVIS=1 sh install-relevant-react.sh)'\n skip-ls-check: true\n - run: npm run test:karma -- --single-run\n continue-on-error: true\n env:\n CHROME_BIN: chromium-browser\n DISPLAY: 99.0\n - run: echo 'karma tests expected to fail'\n\n tests:\n needs: [build]\n name: 'tests'\n runs-on: ubuntu-latest\n continue-on-error: ${{ matrix.continue-on-error == 'true' }}\n\n strategy:\n fail-fast: false\n matrix:\n node-version:\n - '18'\n - '4'\n react:\n - '16.14'\n - '16.13'\n - '16.12'\n - '16.11'\n - '16.10'\n - '16.9'\n - '16.8'\n - '16.7'\n - '16.6'\n - '16.5'\n - '16.4'\n - '16.3'\n - '16.2'\n - '16.1'\n - '16.0'\n - '15.5'\n - '15.4'\n - '15.3'\n - '15.2'\n - '15.1'\n - '15.0'\n - '0.14'\n - '0.13'\n include:\n - node-version: '16'\n react: '16'\n - node-version: '14'\n react: '16'\n - node-version: '12'\n react: '16'\n - node-version: '10'\n react: '16'\n - node-version: '8'\n react: '16'\n - node-version: '6'\n react: '16'\n - node-version: 'lts/*'\n react: '16.8.3'\n - node-version: 'lts/*'\n react: '16.8.5'\n env:\n RENDERER: '16.8.5'\n - node-version: 'lts/*'\n react: '16.8.5'\n env:\n RENDERER: '16.8.3'\n - node-version: 'lts/*'\n react: '16.3'\n env:\n ADAPTER: '16'\n - node-version: 'lts/*'\n react: '16.8'\n env:\n RENDERER: '16.7'\n - node-version: 'lts/*'\n react: '16.7'\n env:\n RENDERER: '16.8'\n - node-version: 'lts/*'\n react: '16.7'\n env:\n RENDERER: '16.7'\n\n steps:\n - uses: actions/checkout@v3\n - uses: actions/cache@v3\n with:\n path: |\n packages/*/build\n node_modules\n packages/*/node_modules\n key: enzyme-${{ github.workflow }}-${{ github.action }}-${{ github.run_id }}\n - run: sudo chmod -R a+w .\n - uses: ljharb/actions/node/install@main\n with:\n node-version: ${{ matrix.node-version || 'lts/* '}}\n skip-install: true\n after_install: '(nvm install node && sh install-relevant-react.sh)'\n skip-ls-check: true\n env:\n REACT: ${{ matrix.react }}\n - run: npm run travis\n - uses: codecov/codecov-action@v3\n\n node:\n name: 'node + react'\n needs: [tests]\n runs-on: ubuntu-latest\n steps:\n - run: 'echo tests completed'\n \n karma:\n name: 'node + react + karma'\n needs: [karma-matrix]\n runs-on: ubuntu-latest\n steps:\n - run: 'echo tests completed'\n" }, { "path": ".github/workflows/rebase.yml", "content": "name: Automatic Rebase\n\non: [pull_request_target]\n\njobs:\n _:\n name: \"Automatic Rebase\"\n\n runs-on: ubuntu-latest\n\n steps:\n - uses: actions/checkout@v3\n - uses: ljharb/rebase@master\n env:\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n" }, { "path": ".github/workflows/require-allow-edits.yml", "content": "name: Require “Allow Edits”\n\non: [pull_request_target]\n\njobs:\n _:\n name: \"Require “Allow Edits”\"\n\n runs-on: ubuntu-latest\n\n steps:\n - uses: ljharb/require-allow-edits@main\n" }, { "path": ".gitignore", "content": "# Logs\nlogs\n*.log\n\n# Runtime data\npids\n*.pid\n*.seed\n\n# Directory for instrumented libs generated by jscoverage/JSCover\nlib-cov\n\n# Coverage directory used by tools like istanbul\ncoverage\n.nyc_output\n\n# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)\n.grunt\n\n# node-waf configuration\n.lock-wscript\n\n# Compiled binary addons (https://nodejs.org/api/addons.html)\nbuild/Release\n\n# Dependency directory\n# https://www.npmjs.org/doc/misc/npm-faq.html#should-i-check-my-node_modules-folder-into-git\nnode_modules\n\n# Jetbrains IDEs\n.idea\n\n/build\n_book\n\n# Only apps should have lockfiles\nnpm-shrinkwrap.json\npackage-lock.json\nyarn.lock\n\n.DS_Store\n._.DS_Store\n\npackages/*/build/\n\n# Temporarily copied\npackages/*/LICENSE.md\npackages/enzyme/README.md\npackages/enzyme-adapter-react-*/README.md\npackages/enzyme-adapter-utils*/README.md\n\n.npmignore\n" }, { "path": ".lgtm", "content": "approvals = 1\npattern = \"(?i):shipit:|:\\\\+1:|LGTM\"\n" }, { "path": ".npmrc", "content": "package-lock=false\nupdate-notifier=false\nlegacy-peer-deps=true\n" }, { "path": ".nycrc", "content": "{\n \"extension\": [\n \".js\",\n \".jsx\"\n ],\n \"include\": [\n \"*\",\n \"packages/*/*\",\n \"packages/*/src\"\n ],\n \"exclude\": [\n \"packages/enzyme-test-suite\",\n \"_book\",\n \"coverage\",\n \"packages/*/node_modules\"\n ],\n \"require\": [\n ],\n \"reporter\": [\n \"text\",\n \"html\",\n \"json\",\n \"lcov\"\n ],\n \"all\": false,\n \"check-coverage\": false,\n \"statements\": 100,\n \"branches\": 100,\n \"lines\": 100,\n \"functions\": 100,\n \"sourceMap\": true,\n \"instrument\": true\n}\n" }, { "path": "CHANGELOG.md", "content": "# Change Log\n\n## 3.11.0\n\n### New Stuff\n - `render`: handle Fiber strings and numbers (#2221)\n\n### Fixes\n - `shallow`: Share child context logic between `shallow` and `dive` (#2296)\n - `mount`: `children`: include text nodes ($2269)\n - `mount`: `invoke`: use adapter’s `wrapInvoke` if present (#2158)\n\n### Docs\n - `mount`/`shallow`: `closest`/`parent`: Add missing arguments description (#2264)\n - `mount`/`shallow`: fix pluralization of “exist” (#2262)\n - `shallow`/`mount`: `simulate`: added functional component example to simulate doc (#2248)\n - `mount`: `debug`: add missing verbose option flag (#2184)\n - `mount`/`shallow`: `update`: fix semantics description (#2194)\n - add missing backticks to linked method names (#2170)\n - `invoke`: Add missing backticks to end of codeblock (#2160)\n - `invoke`: Fix typo (#2167)\n - Explicit React CSS selector syntax description (#2178)\n\n### Meta Stuff\n - [meta] add `funding` field\n - [meta] Update airbnb.io URLs to use https (#2222)\n - [deps] update `is-boolean-object`, `is-callable`, `is-number-object`, `is-string`, `enzyme-shallow-equal`, `array.prototype.flat`, `function.prototype.name`, `html-element-map`, `is-regex`, `object-inspect`, `object-is`, `object.entries`, `object.vales`, `raf`, `string.prototype.trim`\n - [dev deps] update `eslint`, `eslint-plugin-import`, `eslint-plugin-markdown`, `eslint-plugin-react`, `safe-publish-latest`, `eslint-config-airbnb`, `rimraf`, `safe-publish-latest`, `karma-firefox-launcher`, `babel-preset-airbnb`, `glob-gitignore`, `semver`, `eslint-plugin-jsx-a11y`\n\n## 3.10.0\n\n### New Stuff\n - `shallow` add `suspenseFallback` option; support `Suspense`/`Lazy` (#1975)\n - `shallow`/`mount`: add `invoke(propName)(...args)` (#1856, #945)\n - `shallow`: Support rendering and `dive()`ing `createContext()` providers and consumers (#1966)\n - `mount`/`shallow`: add `getWrappingComponent` (#1960)\n - `Utils`: add `isCustomComponent` (#1960)\n - `Utils`: add `stub` argument to `spyMethod`\n - `EnzymeAdapter`: add `matchesElementType` (#2146)\n - `RSTTraversal`: add `getHTMLFromHostNodes`\n\n### Fixes\n - `selectors`: unwrap `memo` elements - in both directions (#2146)\n - `shallow`: properly determine \"should render\" for `PureComponent`s (#2096)\n - `mount`/`shallow`: `renderProp`: improve error messages (#2070)\n - `mount`: `setContext`: use proper wrapper name in error message\n - `shallow`: `.contains()`: clean up error message\n - `shallow`/`mount`: `hasClass`: avoid a crash with a non-string argument (#2057)\n - `mount`: properly handle HTML of multiple nodes (#2052)\n - `shallow`: ensure that if gDSFP exists, cDU is called. (#2027)\n - `shallow`: Mock sCU if gDSFP defined in shallow renderer rerender (#1981)\n - `mount`: `.state()`: allow getting state from stateful children of a stateless root (#2043)\n - `mount`: `.text()`: properly recurse through fragments and arrays (#2028)\n\n### Refactors\n - `ReactWrapper`/`ShallowWrapper`: ensure calling an adapter‘s nodeToElement preserves the receiver\n - `mount`: use `getHTMLFromHostNodes`\n\n### Docs\n - explain why need to re-call .find() after update (#2140)\n - `shallow`: fix childAt (#2134)\n - Update v2 -> v3 migration guide re props after a stage change (#1300)\n - `debug`: Added documentation for `verbose` flag (#2104)\n - Add on the fly JSDOM include example (#2072)\n - `reduce`/`reduceRight`: fix example code (#2066, #2065, #2064)\n - update `simulateError` with `getDerivedStateFromError` (#2036)\n - `shallow`: `.hasClass`: fix use of `mount`\n - add link to Cheerio API and another example (#756)\n - `jest`: Update deprecated jest config key (#2024)\n\n## 3.9.0\n\n### New Stuff\n - `shallow`: `isEmptyRender`: allow on multiple elements (#1924)\n - `mount`: support `:focus` selector (#1965)\n - `shallow`: Support `getChildContext()` (#1971)\n - `shallow`/`mount`: `.find`: find HTML elements by their constructor (#1933)\n - `shallow`/`mount`: `selectors`: support universal selector (#1945)\n - `mount`/`shallow`: add regex support to `.hasClass` (#1987)\n\n### Fixes\n - `mount`/`shallow`: `.text`/`.html`: handle an array of nodes properly (#2001)\n - `shallow`: `.setProps()`: only call cDU once (#2007)\n - `mount`: ensure `findWhere` doesn‘t abort early on an empty string (#1995)\n - `mount`: `findWhere`: avoid passing empty wrappers to predicate\n - `mount`: `text()` via `findWhere`: return the string for a wrapper around a string\n - `mount`/`shallow`: Fix .exists not accepting any EnzymeSelector (#1934)\n - `mount`: Recursive `isEmptyRender` (#1924)\n - `mount`: `setState`: allow setting state on a class child of an SFC root\n\n### Documentation\n - [jest] update Jest to setupFilesAfterEnv (#2015)\n - [jest] Change deprecated `setupTestFrameworkScriptFile` to `setupFilesAfterEnv` (#2013)\n - `mount`: `setState`: note that you can now call it on \"not the root\" (#2010)\n - general improvements (#1947)\n - Fix typos (#1992)\n - Added missing pages: `isEmptyRender`, `renderProp`, `equals`, SystemJS guide (#1984, #1985)\n - Fix link to .shallow() (#1951)\n - update jsdoc to use \"EnzymeSelector\" where applicable\n\n### Meta Stuff\n - add \"directory\" field to package.json\n\n## 3.8.0\n\n### New Stuff\n - `shallow`/`mount`: add `renderProp` (#1863, #1891)\n\n### Fixes\n - `shallow`/`mount`: improve error message for \"single node\" assertion (#1904)\n - `shallow`: shallow compare, not deep compare, state and props to determine rerendering (#1915)\n\n### Documentation\n - `shallow`: `dive`: add a note about throwing an error (#1905)\n - `selectors: update re `displayName` (#1932)\n - `shallow`: `get`: fixed wrong `props()` usage (#1921)\n - `shallow`: `html`: shallow renders full tree (#1912)\n - Updated broken link for “.hostNodes()” in migration guide from enzyme 2 to 3 (#1909)\n - Add tape example project link (#1898)\n - `prop`: fix typo (#1883)\n - Document full support for attribute selectors (#1881)\n - Documentation update for testing React Native with jsdom (#1873)\n - Update JSDOM docs to include {request|cancel}AnimationFrame polyfills (#1867)\n - `mount`: `ref`: use correct type (#1865)\n\n## 3.7.0\n\n### New Stuff\n - `mount`: `.state()`/`.setState()`: allow calling on children ([#1802](https://github.com/enzymejs/enzyme/pull/1802), @ljharb)\n - `configuration`: add `reset` ([commit](https://github.com/enzymejs/enzyme/commit/d91d95b8da8900c8f4b7090d2256422a82398ca9))\n\n### Fixes\n - `makeOptions`: ensure that config-level `attachTo`/`hydrateIn` are inherited into wrapper options ([#1836](https://github.com/enzymejs/enzyme/issues/1836), @ljharb)\n - `shallow`/`Utils`: call into adapter’s `isCustomComponentElement` if present ([#1832](https://github.com/enzymejs/enzyme/pull/1832), @SinHouse)\n - `shallow`/`mount`: throw an explicit error when state is null/undefined ([commit](https://github.com/enzymejs/enzyme/commit/9ea33d7667a93885d6f1d6e12b0c2661d6d47cd1))\n - freeze `ROOT_NODES` for child wrappers ([#1811](https://github.com/enzymejs/enzyme/pull/1811), @jgzuke)\n - `shallow`: `.parents`: ensure that one `.find` call does not affect another ([#1781](https://github.com/enzymejs/enzyme/pull/1781), @ljharb)\n - `mount`: update after `simulateError` ([#1812](https://github.com/enzymejs/enzyme/pull/1812), @jgzuke)\n\n### Refactors\n - `mount`/`shallow`: `getElement`: use `this.single` ([commit](https://github.com/enzymejs/enzyme/commit/6b63db3b002a419076c82d34554916400ef392fa))\n\n## 3.6.0\n\n### New Stuff\n - `shallow`/`mount`: add `simulateError` ([#1797](https://github.com/enzymejs/enzyme/pull/1797), @ljharb)\n\n## 3.5.1\n\n### Fixes\n- `shallow`/`mount`: `containsMatchingElement`: trim whitespace ([commit](https://github.com/enzymejs/enzyme/commit/171e952), [#636](https://github.com/enzymejs/enzyme/issues/636))\n- `debug`: inspect objects instead of showing them as `` ([commit](https://github.com/enzymejs/enzyme/commit/a7b6e78))\n\n### Documentation\n- `mount`: `ref`: Update docs to be consistent with v3 ([#1242](https://github.com/enzymejs/enzyme/pull/1242), @adam-golab)\n\n### Refactors\n- `shallow`/`mount`: make tests and method ordering more consistent ([commit](https://github.com/enzymejs/enzyme/commit/d0fccaf))\n- RSTTraversal: remove unnecessary `adapter` truthiness check ([commit](https://github.com/enzymejs/enzyme/commit/394a327))\n\n## 3.5.0\n\n### New Stuff\n- Add forwardRef support ([#1592](https://github.com/enzymejs/enzyme/pull/1592), @jquense)\n- Add Portal support ([#1760](https://github.com/enzymejs/enzyme/pull/1760), [#1761](https://github.com/enzymejs/enzyme/pull/1760), [#1772](https://github.com/enzymejs/enzyme/pull/1772), [#1774](https://github.com/enzymejs/enzyme/pull/1774), @jgzuke)\n- Add pointer events support ([#1753](https://github.com/enzymejs/enzyme/pull/1753), @ljharb)\n\n### Fixes\n- preemptively fix compat with React v16.4.3 ([#1790](https://github.com/enzymejs/enzyme/pull/1790), [#1778](https://github.com/enzymejs/enzyme/pull/1778), @gaearon, @aweary)\n- `shallow`: prevent rerenders with PureComponents ([#1786](https://github.com/enzymejs/enzyme/pull/1786), @koba04)\n- `shallow`: skip updates when nextState is `null` or `undefined` ([#1785](https://github.com/enzymejs/enzyme/pull/1785), @koba04)\n- `shallow`: `setState` after `setProps` calls `componentWillReceiveProps` ([#1779](https://github.com/enzymejs/enzyme/pull/1779), @peanutenthusiast)\n- `mount`/`shallow`: be stricter on the wrapper’s setState/setProps callback ([commit](https://github.com/enzymejs/enzyme/commit/ff11d2219da575d09ca8edfa19df42b8f78b506f))\n- `shallow`/`mount`: improve error message when wrapping invalid elements ([#1759](https://github.com/enzymejs/enzyme/pull/1759), @jgzuke)\n\n### Refactors\n- remove most uses of lodash ([commit](https://github.com/enzymejs/enzyme/commit/89b39b6f1c59aa771f4452a27b159f7aa2616e84))\n\n### Meta Stuff\n- ensure a license and readme is present in all packages when published\n\n## 3.4.4\n\n### Fixes\n- @koba04: `shallow`: fix unexpected call to componentDidMount ([#1768](https://github.com/enzymejs/enzyme/pull/1768))\n\n## 3.4.3\n\n### Fixes\n- @ljharb/@koba04: `shallow`: `.setState()`: stub out `setState` on non-root code paths as well ([#1763](https://github.com/enzymejs/enzyme/pull/1763))\n- @ljharb: `shallow`/`mount`: restore fallback when adapter lacks `invokeSetStateCallback` ([commit](https://github.com/enzymejs/enzyme/commit/093b2edb98d3abfe6b61d800503e04aac08e7496))\n- @ljharb: `mount`: `setState`: invoke callback with the proper receiver ([commit](https://github.com/enzymejs/enzyme/commit/ec3beef3ba86c4352fe6e9ab2848b3b4f61ac1da))\n- @ljharb: `mount`: `state` and `setState` should throw an explicit error message when called on an SFC ([commit](https://github.com/enzymejs/enzyme/commit/8feee5a89e9091636e9ec0ec3814d287ced20136))\n\n## 3.4.2\n\n### Fixes\n- @koba04: `shallow`: call cDU when an instance calls setState ([#1742](https://github.com/enzymejs/enzyme/pull/1742))\n- @ReactiveRaven: `selectors`: fix descendant selector ([#1680](https://github.com/enzymejs/enzyme/pull/1680))\n\n## 3.4.1\n\n### Fixes\n\n- @ljharb: `shallow`: `setProps`: merge instead of replace props ([commit](https://github.com/enzymejs/enzyme/commit/9b4d0276f57e54be06aca6c3636120b3c4053310))\n\n### Documentation\n\n- @koba04: Fix an adapter table style in README.md and a migration guide ([#1734](https://github.com/enzymejs/enzyme/pull/1734))\n\n## 3.4.0\n\n### New Stuff\n\n- @madicap: `shallow`/`mount`: account for React.Fragment nodes ([#1733](https://github.com/enzymejs/enzyme/pull/1733))\n- @jquense: Debug: `debugNode` now returns `[function]` for function children ([commit](https://github.com/enzymejs/enzyme/commit/9745de0bf25e826186be07e7846f4ecd7c685592))\n- @ljharb: `mount`: add `hydrateIn` option ([#1707](https://github.com/enzymejs/enzyme/pull/1707))\n- @ljharb: `shallow`: add “lifecycles” adapter option ([#1696](https://github.com/enzymejs/enzyme/pull/1696))\n- @krawaller: `shallow`/`mount`: allow `.exists()` to take an optional selector ([#1695](https://github.com/enzymejs/enzyme/pull/1695))\n- @koba04: `shallow`: Add getSnapshotBeforeUpdate support ([#1657](https://github.com/enzymejs/enzyme/pull/1657))\n- @jquense: `shallow`/`mount`: Add support for some pseudo selectors ([#1537](https://github.com/enzymejs/enzyme/pull/1537))\n- @blainekasten: `debug`: Implement verbose debug output ([#1547](https://github.com/enzymejs/enzyme/pull/1547))\n- @jquense/@ljharb: `Debug`: `typeName` now calls the adapter’s `displayNameOfNode` if available ([#1701](https://github.com/enzymejs/enzyme/pull/1701))\n- @jquense/@ljharb: `mount`/`shallow`: `.name()`: call into adapter’s `displayNameOfNode`, if present ([#1701](https://github.com/enzymejs/enzyme/pull/1701))\n- @jquense/@ljharb: `Utils`: `nodeHasType`: call into adapter’s `displayNameOfNode`, if present ([#1701](https://github.com/enzymejs/enzyme/pull/1701))\n- @jquense/@ljharb: `selectors`: `buildPredicate`: call into adapter’s `isValidElementType`, if present ([#1701](https://github.com/enzymejs/enzyme/pull/1701))\n- @emuraton/@ljharb: `shallow`: `setProps()`: Add callback argument ([#1721](https://github.com/enzymejs/enzyme/pull/1721))\n- @ljharb: `mount`: add `.equals()` ([commit](https://github.com/enzymejs/enzyme/commit/dcc8ab10fde06a963364f6cc79b89aa967d9bef2))\n- @madicap: Extract `getAdapter` from `Utils` into its own file ([#1732](https://github.com/enzymejs/enzyme/pull/1732))\n\n### Fixes\n\n- @ljharb: `shallow`/`mount`: `matchesElement`/`containsMatchingElement`: get adapter with options ([commit](https://github.com/enzymejs/enzyme/commit/e954e4610d1ad89ae94b8f7c7baa8835cd331662))\n- @ljharb: `RSTTraversal`: remove `nodeHasProperty` export; broken since #1157 ([commit](https://github.com/enzymejs/enzyme/commit/edabb1b6b4648fb6469da43feb1d15c1b55666f7))\n- @ljharb/@KordonDev: `shallow`: `.at()`: return an empty wrapper when an index does not exist ([#1478](https://github.com/enzymejs/enzyme/pull/1478))\n- @ljharb: `shallow`: `.equals()`: flatten children when comparing ([commit](https://github.com/enzymejs/enzyme/commit/18de4ed2e68c25f9fff9983d996b024704183801))\n- @ljharb: `mount`/`shallow`: do not dedupe in flatMap ([commit](https://github.com/enzymejs/enzyme/commit/72341740e1e650b16ca2e377fa4e3e144b35a558))\n- @ljharb: `shallow`: `.closest()`: ensure an empty wrapper is returned for no match ([commit](https://github.com/enzymejs/enzyme/commit/ce1e1132d080948265567e88417dface9c0c45e7))\n- @krawaller: `selectors`: make general sibling not throw on root ([#1698](https://github.com/enzymejs/enzyme/pull/1698))\n- @ljharb/@angelikatyborska : `mount`: `text()`: null nodes return null ([#1582](https://github.com/enzymejs/enzyme/pull/1582))\n- @ljharb: `shallow`: `simulate`: ensure it returns itself ([commit](https://github.com/enzymejs/enzyme/commit/1c2c58b4e554f3b0c5f862f8de79f15a62bef5cf))\n- @koba04: `shallow`: ShallowWrapper calls update() automatically ([#1499](https://github.com/enzymejs/enzyme/pull/1499))\n- @bdwain: `mount`/`shallow`: return null for missing keys ([#1536](https://github.com/enzymejs/enzyme/pull/1536))\n- @vsiao: Fix ShallowWrapper for array-rendering components ([#1498](https://github.com/enzymejs/enzyme/pull/1498))\n- @koba04: Call `setState` callback after finishing the render ([#1453](https://github.com/enzymejs/enzyme/pull/1453))\n- @eddyerburgh: Convert nodes to RST nodes before comparing ([#1423](https://github.com/enzymejs/enzyme/pull/1423))\n- @ljharb: improve \"bad adapter\" error message ([#1477](https://github.com/enzymejs/enzyme/pull/1477))\n- @ljharb: `shallow`/`mount`: default iterator should be iterable ([commit](https://github.com/enzymejs/enzyme/commit/cfc5a3e47efa812f7a2c4fa5ad2b0687daacd280))\n\n### Refactors\n\n- @ReactiveRaven: `selectors`: fix typos; avoid reusing variable unnecessarily ([#1681](https://github.com/enzymejs/enzyme/pull/1681))\n- @koba04/@ljharb: `shallow`: Use `spyMethod` to inspect the result of `shouldComponentUpdate`/`getSnapshotBeforeUpdate` ([#1192](https://github.com/enzymejs/enzyme/pull/1192))\n- @ljharb: `Utils`: `configuration`: change to named exports. ([commit](https://github.com/enzymejs/enzyme/commit/d7f32617e6ea93b739f4e4c3f6228a8e382aeb06))\n- @ljharb: use `array.prototype.flat` ([commit](https://github.com/enzymejs/enzyme/commit/e52a02ddac0fab0d1d93fd57d7f073f8bdc850bf))\n\n### Documentation\n\n- @jack-lewin: Clarify dev workflow in CONTRIBUTING.md ([#1207](https://github.com/enzymejs/enzyme/pull/1207))\n- @robrichard: Provide migration instructions for `ref(refName)` ([#1470](https://github.com/enzymejs/enzyme/pull/1470))\n- @DannyDelott: `shallow`/`mount`: Add callback arg to setProps header ([#1361](https://github.com/enzymejs/enzyme/pull/1361))\n- @conor-cafferkey-sociomantic: `mount`: Updated docs for ReactWrapper.instance(); remove docs for v2's `getNode()`/`getNodes()` ([#1714](https://github.com/enzymejs/enzyme/pull/1714))\n- @koba04: Make clearer the docs for .mount() ([#1540](https://github.com/enzymejs/enzyme/pull/1540))\n- @ialexryan: Update signature of .type() in shallow.md (#1492]([https://github.com/enzymejs/enzyme/pull/1492))\n\n### Meta Stuff\n\n- @ljharb: ensure a license and readme is present in all packages when published\n- @ljharb: [meta] fix package.json scripts\n\n## 3.3.0\n\n### New Stuff\n\n- @ljharb/@joeldenning: `debug`: handle boxed primitives ([#1450](https://github.com/enzymejs/enzyme/pull/1450))\n\n### Refactors\n- @eddyerburgh: Use RSTTraversal childrenOfNode in Utils ([#1381](https://github.com/enzymejs/enzyme/pull/1381))\n\n### Fixes\n- @nicoder: Fix typo in error message ([#1379](https://github.com/enzymejs/enzyme/pull/1379))\n\n## 3.2.0\n\n### New Stuff\n\n- @aweary: Support all attribute selector operators ([#1157](https://github.com/enzymejs/enzyme/pull/1157))\n\n### Fixes\n\n- @idanilt: Change ShallowWrapper.text() trim spaces with same behavior as ReactWrapper.text() ([#1350](https://github.com/enzymejs/enzyme/pull/1350))\n\n## 3.1.1\n\n### Fixes\n\n- @koba04: Fix to call componentDidUpdate on setState of React v16 ([#1261](https://github.com/enzymejs/enzyme/pull/1261))\n\n## 3.1.0\n\n### New Stuff\n\n- @FezVrasta: Added hostNodes method to ReactWrapper ([#1179](https://github.com/enzymejs/enzyme/pull/1179))\n\n### Fixes\n\n- @lelandrichardson: Add an npmignore file to all packages ([#1204](https://github.com/enzymejs/enzyme/pull/1204))\n\n- @neoziro: Fix node resolving in React 16 adapter ([#100](https://github.com/enzymejs/enzyme/pull/100))\n\n- @graingert: upgrade to rst-selector-parser@^2.2.2 ([#1146](https://github.com/enzymejs/enzyme/pull/1146))\n\n### Documentation\n\n- @lelandrichardson: Symlink readme to all packages ([#1205](https://github.com/enzymejs/enzyme/pull/1205))\n\n- @AndersDJohnson: fix some typos ([#1165](https://github.com/enzymejs/enzyme/pull/1165))\n\n- @dubbha: ES5 setup file correction ([#1194](https://github.com/enzymejs/enzyme/pull/1194))\n\n- @morrowr08: updated component name being used in example ([#1180](https://github.com/enzymejs/enzyme/pull/1180))\n\n- @apandichi: Fixing a few typos... ([#1171](https://github.com/enzymejs/enzyme/pull/1171))\n\n- @nuc: Fix typo ([#1142](https://github.com/enzymejs/enzyme/pull/1142))\n\n## 3.0.0\n\n### Breaking Changes\n\nEnzyme has several breaking changes from v2 to v3. Please check out our [migration guide](/docs/guides/migration-from-2-to-3.md) for more info. Since there was a rewrite of the core\nlibrary from v2 to v3, it is hard to categorize changes in terms of sem\n\n - @lelandrichardson: Refactor enzyme to use Adapters, initial React 16 support ([#1007](https://github.com/enzymejs/enzyme/pull/1007))\n\n - @lelandrichardson: Make private properties more private and harder to use ([#1083](https://github.com/enzymejs/enzyme/pull/1083))\n\n - @ljharb: [breaking] update `cheerio` to v1 ([#1093](https://github.com/enzymejs/enzyme/pull/1093))\n\n - @aweary: Integrate with a CSS parser for selector parsing ([#1086](https://github.com/enzymejs/enzyme/pull/1086))\n\n - @vadimdemedes: Skip undefined props when comparing nodes ([#662](https://github.com/enzymejs/enzyme/pull/662))\n\n - @koba04: Breaking: lifecycleExperimental by default ([#1140](https://github.com/enzymejs/enzyme/pull/1140))\n\n\n### New Stuff\n\n - @lelandrichardson: Move to lerna repo structure, multiple modules ([#1074](https://github.com/enzymejs/enzyme/pull/1074))\n\n - @lelandrichardson: Remove all React dependencies from enzyme ([#1084](https://github.com/enzymejs/enzyme/pull/1084))\n\n - @lelandrichardson: Add public root method ([#1127](https://github.com/enzymejs/enzyme/pull/1127))\n\n\n\n ### Fixes\n\n - @aweary: Remove isFunctionalComponent, use nodeType instead ([#1076](https://github.com/enzymejs/enzyme/pull/1076))\n\n - @LarsHassler: props not merged when shallow rendering in lifecycleExperimental ([#1088](https://github.com/enzymejs/enzyme/pull/1088))\n\n - @ljharb: [Fix] `mount`: do not mutate `Component.contextTypes` ([#1099](https://github.com/enzymejs/enzyme/pull/1099))\n\n - @ljharb: [Fix] `reduce`/`reduceRight`: follow `Array#reduce` when omitting initialValue ([#673](https://github.com/enzymejs/enzyme/pull/673))\n\n - @koba04: Fix componentDidUpdate when updating by setState on v16 ([#1133](https://github.com/enzymejs/enzyme/pull/1133))\n\n - @koba04: Fix componentDidUpdate no longer receives prevContext on React v16 ([#1139](https://github.com/enzymejs/enzyme/pull/1139))\n\n\n\n ### Documentation\n\n - @ghost: added sinon to mocha guide ([#1075](https://github.com/enzymejs/enzyme/pull/1075))\n\n - @samit4me: Update to GitBook 3 ([#1039](https://github.com/enzymejs/enzyme/pull/1039))\n\n - @therewillbecode: Removed extraneous brackets from example in readme ([#1117](https://github.com/enzymejs/enzyme/pull/1117))\n\n - @silvenon: Add note that mount() requires cleanup ([#1043](https://github.com/enzymejs/enzyme/pull/1043))\n\n - @lelandrichardson: Add docs reflecting v3 ([#1121](https://github.com/enzymejs/enzyme/pull/1121))\n\n\n\n\n## 2.9.1\n\n### Fixes\n\n - [Deps] Require uuid at least 3.0.1 ([#1001](https://github.com/enzymejs/enzyme/pull/1001))\n\n## 2.9.0\n\n### New Stuff\n\n - `mount`/`shallow`: `debug`: add `ignoreProps` option ([#960](https://github.com/enzymejs/enzyme/pull/960))\n\n### Fixes\n\n - `shallow`: debug: fix indentation ([#926](https://github.com/enzymejs/enzyme/pull/926))\n - react-compat: Make sure dependency error reporting always work ([#929](https://github.com/enzymejs/enzyme/pull/929))\n - react-compat: correct error message ([#904](https://github.com/enzymejs/enzyme/pull/904))\n\n### Documentation\n\n - lint our markdown ([#988](https://github.com/enzymejs/enzyme/pull/988))\n - correct `nvm` install instructions (never install it with homebrew) ([#988](https://github.com/enzymejs/enzyme/pull/988))\n - fix typos ([#979](https://github.com/enzymejs/enzyme/pull/979)), ([#983](https://github.com/enzymejs/enzyme/pull/983))\n - Added missing isEmptyRender() docs\n - update jsdom guides for v10 and later ([#921](https://github.com/enzymejs/enzyme/pull/921))\n\n### Refactors\n\n - `shallow`/`mount`: Make all references to the wrapper `class` call into `this.wrap`\n - update `uuid` from v2 to v3 ([#998](https://github.com/enzymejs/enzyme/pull/998))\n\n## 2.8.2\n\n### Fixes\n\n - Loosen react-compat implicit dependency logic for React 15.4 ([#896](https://github.com/enzymejs/enzyme/pull/896))\n\n### Documentation\n\n - Update docs to use `prop-types` ([#894](https://github.com/enzymejs/enzyme/pull/894), [#890](https://github.com/enzymejs/enzyme/issues/890))\n\n## 2.8.1\n\n### Fixes\n\n- support React@15.5 ([#876](https://github.com/enzymejs/enzyme/pull/876))\n- no longer depend on `React.createClass` ([#877](https://github.com/enzymejs/enzyme/pull/877))\n- Throw for malformed compound selectors ([#868](https://github.com/enzymejs/enzyme/pull/868))\n\n## 2.8.0\n\n### New Stuff\n\n- add disableLifecycleMethods for shallow ([#789](https://github.com/enzymejs/enzyme/pull/789))\n- Match children before and after interpolation ([#512](https://github.com/enzymejs/enzyme/pull/512))\n- Supporting passing context to static rendering ([#429](https://github.com/enzymejs/enzyme/pull/429))\n\n\n### Fixes\n\n- Fix an issue w/ cleaning up global.document ([#855](https://github.com/enzymejs/enzyme/pull/855))\n- Update props when shouldComponentUpdate returns `false` and `lifecycleExperimental` is on ([#807](https://github.com/enzymejs/enzyme/pull/807))\n- Properly pass along options in `dive` ([#771](https://github.com/enzymejs/enzyme/pull/771))\n\n## 2.7.1 (January 22, 2017)\n\n### Fixes\n\n- `mount`: Fix bug from ([#677](https://github.com/enzymejs/enzyme/pull/677) ([#680](https://github.com/enzymejs/enzyme/pull/680))\n- `mount`: ignore text nodes in childrenOfInst ([#604](https://github.com/enzymejs/enzyme/pull/604))\n\n### Documentation\n\n- Update Docs for .getNode and .getNodes ([#743](https://github.com/enzymejs/enzyme/pull/743))\n- Add a link for `ShallowWrapper#dive()` ([#759](https://github.com/enzymejs/enzyme/pull/759)\n- Fix alphabetical order of API lists ([#761](https://github.com/enzymejs/enzyme/pull/761))\n\n## 2.7.0 (December 21, 2016)\n\n### New Stuff\n\n- `shallow`/`mount`: Add `.slice()` method ([#661](https://github.com/enzymejs/enzyme/pull/661))\n- `mount`: implement ReactWrapper#getDOMNode ([#679](https://github.com/enzymejs/enzyme/pull/679))\n- `shallow`/`mount`: Add `exists`; deprecate isEmpty() ([#722](https://github.com/enzymejs/enzyme/pull/722))\n\n### Fixes\n\n- `mount`: extract MountedTraversal.hasClassName from MountedTraversal.instHasClassName, which allows ReactWrapper.hasClass to bypass the !isDOMComponent(inst) call ([#677](https://github.com/enzymejs/enzyme/pull/677))\n- `withDom`: Display a useful error when `withDom` fails to find \"jsdom\" ([#686](https://github.com/enzymejs/enzyme/pull/686))\n- `mount`: ensure that `react-text` comment nodes don’t break `.find` ([#691](https://github.com/enzymejs/enzyme/pull/691))\n- `mount`: `.parents()` now filters out sibling path trees ([#713](https://github.com/enzymejs/enzyme/pull/713))\n\n## 2.6.0 (November 9, 2016)\n\n### New Stuff\n\n- ensure ShallowWrapper render output can't get stale ([#490](https://github.com/enzymejs/enzyme/pull/490))\n\n### Fixes\n\n- Use shim to detect constructor function name ([#659](https://github.com/enzymejs/enzyme/pull/659))\n- `mount`/`shallow`: fix ID selectors ([#670](https://github.com/enzymejs/enzyme/pull/670))\n\n\n## 2.5.2 (November 9, 2016)\n\n### Fixes\n\n- Use shim to detect constructor function name ([#659](https://github.com/enzymejs/enzyme/pull/659))\n- `mount`/`shallow`: fix ID selectors ([#670](https://github.com/enzymejs/enzyme/pull/670))\n\n\n## 2.5.1 (October 17, 2016)\n\n### Patches\n\n- continue to support one-argument `single` ([#632](https://github.com/enzymejs/enzyme/pull/632))\n\n\n## 2.5.0 (October 17, 2016)\n\n### Minor Changes\n\n- pass callback on setState and setProps ([#617](https://github.com/enzymejs/enzyme/pull/617))\n\n- Make ReactWrapper and ShallowWrapper iterable ([#594](https://github.com/enzymejs/enzyme/pull/594))\n\n- add `.dive()` method to `shallow` ([#618](https://github.com/enzymejs/enzyme/pull/618))\n\n\n### Patches\n\n- Warn if selector contains a pseudo-class ([#591](https://github.com/enzymejs/enzyme/pull/591))\n\n- change isCompoundSelector to not match prop selector ([#595](https://github.com/enzymejs/enzyme/pull/595))\n\n- fixed hasClassName in case className is not a string and has toString method ([#518](https://github.com/enzymejs/enzyme/pull/518))\n\n- Throw if some() is called on a root wrapper ([#523](https://github.com/enzymejs/enzyme/pull/523))\n\n- Fix valid + falsy propvalues ([#563](https://github.com/enzymejs/enzyme/pull/563))\n\n\n## 2.4.2 (November 9, 2016)\n\n### Fixes\n\n- Use shim to detect constructor function name ([#659](https://github.com/enzymejs/enzyme/pull/659))\n- `mount`/`shallow`: fix ID selectors ([#670](https://github.com/enzymejs/enzyme/pull/670))\n\n\n## 2.4.1 (July 8, 2016)\n\n### Patches\n\n- Fix backwards incompatible `shouldComponentUpdate` call ([#491](https://github.com/enzymejs/enzyme/pull/491))\n\n\n## 2.4.0 (July 7, 2016)\n\n### Minor Changes\n\n- Support all Component Lifecycle methods in ShallowRenderer (behind an experimental flag) ([#318](https://github.com/enzymejs/enzyme/pull/318))\n\n- Add an `isEmptyRender()` method to both `ShallowWrapper` and `ReactWrapper` ([#339](https://github.com/enzymejs/enzyme/pull/339))\n\n- Add support for batched updates with `ShallowRender.simulate` ([#342](https://github.com/enzymejs/enzyme/pull/342))\n\n\n### Patches\n\n- Switch to using classList instead of className ([#448](https://github.com/enzymejs/enzyme/pull/448))\n\n- fixes mount().debug() output with mixed children ([#476](https://github.com/enzymejs/enzyme/pull/476))\n\n- Support additional characters in attribute selectors ([#412](https://github.com/enzymejs/enzyme/pull/412))\n\n- fix id selector not working when combined with a tag selector ([#387](https://github.com/enzymejs/enzyme/pull/387))\n\n- Support spaces in attribute selector values ([#427](https://github.com/enzymejs/enzyme/pull/427))\n\n\n\n## 2.3.0 (May 9, 2016)\n\n### Minor Changes\n\n- add `.tap()` method to `ShallowWrapper` and `ReactWrapper` ([#299](https://github.com/enzymejs/enzyme/pull/299))\n\n- add `.key()` method to `ShallowWrapper` and `ReactWrapper` ([#327](https://github.com/enzymejs/enzyme/pull/327))\n\n- add support for descendent selectors, `>`, `~` and `+` ([#217](https://github.com/enzymejs/enzyme/pull/217))\n\n- new `containsMatchingElement`, `containsAllMatchingElements`, and `containsAnyMatchingElements` APIs ([#362](https://github.com/enzymejs/enzyme/pull/362))\n\n- new `.name()` method ([#335](https://github.com/enzymejs/enzyme/pull/335))\n\n\n### Patches\n\n- add `dblclick` to eventType map for simulate ([#317](https://github.com/enzymejs/enzyme/pull/317))\n\n- fix `pathToNode` bug with child-containing children ([#296](https://github.com/enzymejs/enzyme/pull/296))\n\n- prioritize `displayName` over `name` for consistency in `.debug()` ([#332](https://github.com/enzymejs/enzyme/pull/332))\n\n- handle insignificant whitespace in className ([#348](https://github.com/enzymejs/enzyme/pull/348))\n\n- fix handling of SFC components and `.instance()` ([#359](https://github.com/enzymejs/enzyme/pull/359))\n\n- reduce false positives by using argument validation for `.contains` ([#259](https://github.com/enzymejs/enzyme/pull/259))\n\n- fix equality algorithm so that non-renderable nodes are equivalent ([#192](https://github.com/enzymejs/enzyme/pull/192))\n\n- add better error handling for `state`, `setState`, and `context` ([#373](https://github.com/enzymejs/enzyme/pull/373))\n\n\n\n\n## 2.2.0 (March 21, 2016)\n\n### Minor Changes\n\n- add `options` param to `ShallowWrapper::shallow` ([#275](https://github.com/enzymejs/enzyme/pull/275))\n\n\n### Patches\n\n- make enzyme compatible with all React 15 RCs ([#272](https://github.com/enzymejs/enzyme/pull/272))\n\n- increase coverage for Stateless Functional Components ([#267](https://github.com/enzymejs/enzyme/pull/267))\n\n- improve context support for Stateless Functional Components ([#256](https://github.com/enzymejs/enzyme/pull/256))\n\n- fix tree traversal for Stateless Functional Components ([#257](https://github.com/enzymejs/enzyme/pull/257))\n\n- fix `.find` for nested Stateless Functional Components ([#274](https://github.com/enzymejs/enzyme/pull/274))\n\n- fix `.props()` and `.debug()` methods for Stateless Functional Components ([#255](https://github.com/enzymejs/enzyme/pull/255))\n\n- prevent falsy nodes from being counted as children ([#251](https://github.com/enzymejs/enzyme/pull/251))\n\n\n## 2.1.0 (March 10, 2016)\n\n### Minor Changes\n\n- add support for React 15.0.0-rc.1 ([#240](https://github.com/enzymejs/enzyme/pull/240))\n\n- add `.unmount()` method for ShallowWrapper ([#215](https://github.com/enzymejs/enzyme/pull/215))\n\n- add direct imports for `mount`, `shallow`, and `render` ([#198](https://github.com/enzymejs/enzyme/pull/198))\n\n- add a `.childAt(n)` shorthand method ([#187](https://github.com/enzymejs/enzyme/pull/187))\n\n\n### Patches\n\n- fix bug in .contains() for matching sub-arrays ([#226](https://github.com/enzymejs/enzyme/pull/226))\n\n- fix bug in matching by type displayName ([#230](https://github.com/enzymejs/enzyme/pull/230))\n\n- add more useful warnings for missing implicit dependencies ([#228](https://github.com/enzymejs/enzyme/pull/228))\n\n- improve SFC support for `.type()` ([#196](https://github.com/enzymejs/enzyme/pull/196))\n\n- fix null handling for `.html()` and `.render()` ([#196](https://github.com/enzymejs/enzyme/pull/196))\n\n- moved from `underscore` to `lodash` ([#189](https://github.com/enzymejs/enzyme/pull/189))\n\n\n## 2.0.0 (February 10, 2016)\n\n### Major Changes (breaking)\n\n- removed `describeWithDOM` utility ([#159](https://github.com/enzymejs/enzyme/pull/159))\n\n- removed `useSinon`, `spyPrototype` and `spyLifecycle` utilities ([#159](https://github.com/enzymejs/enzyme/pull/159))\n\n- removed `sinon` dependency ([#159](https://github.com/enzymejs/enzyme/pull/159))\n\n- removed `jsdom` dependency ([#159](https://github.com/enzymejs/enzyme/pull/159))\n\n\n## 1.6.0 (February 10, 2016)\n\n### Minor Changes\n\n- add option for childContextTypes of `ReactWrapper` ([#171](https://github.com/enzymejs/enzyme/pull/171))\n\n\n### Patches\n\n- Prevent null or false nodes from being passed into tree traversal ([#174](https://github.com/enzymejs/enzyme/pull/174))\n\n- setProps no longer swallows exceptions ([#170](https://github.com/enzymejs/enzyme/pull/170))\n\n- `.type()` and `.props()` should not fail on null now ([#162](https://github.com/enzymejs/enzyme/pull/162))\n\n\n\n## 1.5.0 (February 2, 2016)\n\n### Minor Changes\n\n- Add `attachTo` option to `mount` to mount to a specific element ([#160](https://github.com/enzymejs/enzyme/pull/160))\n\n- Add `.debug()` method to `ReactWrapper` ([#158](https://github.com/enzymejs/enzyme/pull/158))\n\n- Add `.mount()` and `.unmount()` APIs to `ReactWrapper` ([#155](https://github.com/enzymejs/enzyme/pull/155))\n\n- Add `.render()` method to `ReactWrapper` ([#156](https://github.com/enzymejs/enzyme/pull/156))\n\n- Allow `.contains()` to accept an array of nodes ([#154](https://github.com/enzymejs/enzyme/pull/154))\n\n- Add `.context()` method to `ReactWrapper` and `ShallowWrapper` ([#152](https://github.com/enzymejs/enzyme/pull/152))\n\n### Patches\n\n- Fixed some behavior with `.contains()` matching on strings ([#148](https://github.com/enzymejs/enzyme/pull/148))\n\n- Fixed `.debug()`'s output for numeric children ([#149](https://github.com/enzymejs/enzyme/pull/149))\n\n- Documentation fixes\n\n- Update versions of dependencies\n\n\n\n## 1.4.1 (January 24, 2016)\n\n### Patches\n\n- Upgrade to babel 6 ([#81](https://github.com/enzymejs/enzyme/pull/81))\n\n- Fix event naming bug in ShallowWrapper ([#135](https://github.com/enzymejs/enzyme/pull/135))\n\n- Documentation fixes\n\n\n## 1.4.0 (January 21, 2016)\n\n### Minor Changes\n\n- `describeWithDOM` enhancement ([#126](https://github.com/enzymejs/enzyme/pull/126))\n\n- add `.equals()` method to `ShallowWrapper` ([#124](https://github.com/enzymejs/enzyme/pull/124))\n\n- add object selector syntax ([#110](https://github.com/enzymejs/enzyme/pull/110))\n\n### Patches\n\n- Fixed confusing behavior of prop selector syntax ([#130](https://github.com/enzymejs/enzyme/pull/130))\n\n- Documentation fixes\n\n\n\n## 1.3.1 (January 15, 2016)\n\n### Patches\n\n- Fix setProps not passing old context ([#121](https://github.com/enzymejs/enzyme/pull/121))\n\n- Map lowercase mouse events in simulate ([#77](https://github.com/enzymejs/enzyme/pull/77))\n\n\n\n## 1.3.0 (January 13, 2016)\n\n### Minor Changes\n\n- Added `.html()` method to `ReactWrapper` ([#71](https://github.com/enzymejs/enzyme/pull/71))\n\n- Support property selector (i.e. `[prop=\"foo\"]`) ([#70](https://github.com/enzymejs/enzyme/pull/70))\n\n- jsdom dependency now allows a range of supported versions ([#95](https://github.com/enzymejs/enzyme/pull/95))\n\n### Patches\n\n- Normalized `setProps()` behavior between `mount`/`shallow` to merge props ([#103](https://github.com/enzymejs/enzyme/pull/103))\n\n- Exclude `_book` from published package ([#85](https://github.com/enzymejs/enzyme/pull/85))\n\n- Various documentation, tests, and style changes\n\n\n## 1.2.0 (December 10, 2015)\n\n### Minor Changes\n\n- Support for context ([#62](https://github.com/enzymejs/enzyme/pull/62))\n\n### Patches\n\n- `nodeHasId` fix for some 0.14 corner cases ([#65](https://github.com/enzymejs/enzyme/pull/65))\n\n\n\n## 1.1.0 (December 7, 2015)\n\n### Minor Changes\n\n- Support for Stateless Functional Components ([#53](https://github.com/enzymejs/enzyme/pull/53))\n\n### Patches\n\n- Tweak `describeWithDOM` messaging ([#48](https://github.com/enzymejs/enzyme/pull/48))\n- Documentation Fixes\n\n\n\n\n## 1.0.0 (December 3, 2015)\n\n- Official Release!\n" }, { "path": "CONTRIBUTING.md", "content": "# Contributing Guide\n\nContributions are welcome and are greatly appreciated! Every little bit helps, and credit will\nalways be given.\n\n\n\n\n## Setting up your environment\n\nAfter forking enzyme to your own github org, do the following steps to get started:\n\n```bash\n# clone your fork to your local machine\ngit clone https://github.com/enzymejs/enzyme.git\n\n# step into local repo\ncd enzyme\n\n# install dependencies (use `react 13` if you want to use React 0.13)\nnpm install\n\n# install react version\n# accepts `13` for v0.13, `14` for v0.14, and for versions 15+,\n# accepts either a major (`15`, `16`) or a minor (`15.4`, `16.8`)\nnpm run react 16\n```\n\n\n### Switching between React 16, React 15, React 0.14 and React 0.13\n\n```bash\n# switch to React 0.13\nnpm run react 13\n```\n\n```bash\n# switch to React 0.14\nnpm run react 14\n```\n\n```bash\n# switch to React 15\nnpm run react 15\n```\n\n```bash\n# switch to React 16\nnpm run react 16\n```\n\nSpecific versions can also be specified\n\n```bash\n# switch to React 16.5\nnpm run react 16.5\n```\n\n### Running Tests\n\nThe test suite runs on *built* Enzyme.\n\n```bash\n# build Enzyme locally before testing\nnpm run build\n\n# run tests on whatever version of React is currently installed\nnpm test\n```\n\n```bash\n# run tests on all supported versions of React\nnpm run test:all\n```\n\nIf you are actively developing, Enzyme will always need to be built with the latest changes.\n\nFor this, the recommended workflow is to have the build and tests watching for changes in separate terminals. This should provide you with ~realtime feedback:\n\n```bash\n# build Enzyme locally upon save\nnpm run build:watch\n\n# faster feedback for TDD\nnpm run test:watch\n```\n\n### Tests for functionality shared between `shallow` and `mount`\n\nTests for a method \"foo\" are stored in `packages/enzyme-test-suite/test/shared/methods/foo`. The file default exports a function that receives an injected object argument, containing the following properties:\n - `Wrap`: e.g. `shallow`, `mount`\n - `WrapRendered`: this abstracts around the differences between `shallow` and `mount` - e.g., that the root of a shallow wrapper around `Foo` is what `Foo` *renders*, where the root of a mount wrapper around `Foo` is `Foo` itself. Thus, this function produces a wrapper around what `Foo` renders, regardless of the `Wrap` method used.\n - `Wrapper`: e.g. `ShallowWrapper`, `ReactWrapper`\n - `WrapperName`: e.g. `\"ShallowWrapper\"`, `\"ReactWrapper\"`\n - `isShallow`: true if `shallow`. note: needing to use this is a code smell, please avoid.\n - `isMount`: true if `mount`. note: needing to use this is a code smell, please avoid.\n - `makeDOMElement`: in `mount`, makes a real DOM element; in `shallow`, makes a mock object.\n\n These tests are ran via an explicit list in a `describeMethods` call in the ReactWrapper and ShallowWrapper test files. If you add a new test file for a shared method, you'll need to add its name to both calls.\n\n### Style & Linting\n\nThis codebase adheres to the [Airbnb Styleguide](https://github.com/airbnb/javascript) and is\nenforced using [ESLint](https://eslint.org).\n\nAs with the test suite, the linter will not fully pass unless it is running on *built* Enzyme. This is because the ESLint `import/*` rules rely on finding the target files in the filesystem (which won't be there unless they've been built).\n\nIt is recommended that you install an ESLint plugin for your editor of choice when working on this\ncodebase, however you can always check to see if the source code is compliant by running:\n\n```bash\n# build Enzyme locally before linting\nnpm run build\n\nnpm run lint\n```\n\n### Publishing\n\nEnzyme uses [lerna](https://github.com/lerna/lerna) to structure its repo, and has multiple packages\nto publish out of this one repo. We use lerna's \"independent\" mode, which means that the versioning\nof each package in the repo is versioned independently.\n\nWe are waiting on [this issue](https://github.com/lerna/lerna/issues/955) to be fixed, so that\n`peerDependencies` do not get updated with patch updates.\n\nUntil this issue is fixed, we will publish each package manually instead of with `lerna publish`. In\norder to do this, we will:\n\nFor enzyme:\n\n```bash\n# ... update version in enzyme/package.json, make changes to CHANGELOG, etc.\ncd packages/enzyme\ngit commit -m v{version}\ngit tag -a -m v{version}\ngit push --follow-tags\nnpm publish\n```\n\nFor other packages\n\n```bash\n# ... update version in {package}/package.json, make changes to CHANGELOG, etc.\ncd packages/{package}\ngit commit -m \"{package}: v{version}\"\ngit tag -a -m \"{package}: v{version}\"\ngit push --follow-tags\nnpm publish\n```\n\nOnce we are able to use `lerna publish`, the process will be as follows:\n\nLerna by default will only publish packages that have changed since the last release. It will also\ncreate a tagged commit for each release.\n\nTo publish, run:\n\n```bash\nlerna publish -m \"{tag name}\"\n```\n\nThe tag name is determined by the `-m` CLI option. If `enzyme` is one of the packages that has\nupdates, we default to just using that version as the tag name. For instance, when publishing\n`enzyme@3.1.1` and `enzyme-adapter-react-16@1.2.3` we would run:\n\n```bash\nlerna publish -m \"v3.1.1\"\n```\n\nIf `enzyme` is *not* one of the packages being updated, use the other package's name and the version:\n\n```bash\nlerna publish -m \"enzyme-adapter-react-16: v1.2.3\"\n```\n\nThe `lerna publish` command will present interactive prompts asking which version to use for each\npackage independently. Just choose whichever\n\n\n### Building Docs\n\nBuilding the docs locally is extremely simple. First execute the following command:\n\n```bash\nnpm run docs:watch\n```\n\nAfter this, you can open up your browser to the specified port (usually http://localhost:4000 )\n\nThe browser will automatically refresh when there are changes to any of the source files.\n\n\n\n## Pull Request Guidelines\n\nBefore you submit a pull request from your forked repo, check that it meets these guidelines:\n\n1. If the pull request fixes a bug, it should include tests that fail without the changes, and pass\nwith them.\n1. If the pull request adds functionality, the docs should be updated as part of the same PR.\n1. The pull request should work for React 15, React 0.14 and React 0.13. The CI server should run the\ntests in all versions automatically when you push the PR, but if you'd like to check locally, you\ncan do so (see above).\n1. Please rebase and resolve all conflicts before submitting.\n\n" }, { "path": "INTHEWILD.md", "content": "Please use [pull requests](https://github.com/enzymejs/enzyme/pull/new/master) to add your organization and/or project to this document!\n\nOrganizations\n----------\n - [Airbnb](https://github.com/airbnb)\n - [Cerner](https://github.com/cerner)\n - [OpenGov](https://github.com/opengov)\n - [Pinterest](https://github.com/pinterest)\n - [Product Hunt](https://github.com/producthunt)\n - [Walmart Labs](https://github.com/walmartlabs)\n - [Hudl](http://hudl.github.io/)\n - [NET-A-PORTER](https://github.com/NET-A-PORTER)\n - [Rangle.io](https://github.com/rangle)\n - [GoDaddy](https://github.com/godaddy)\n - [Airware](https://github.com/airware)\n - [Flatiron School](https://github.com/flatiron-labs)\n - [Outreach.io](https://github.com/getoutreach)\n - [crowdSPRING](https://crowdspring.com)\n - [nteract](https://nteract.io)\n - [Brave](https://brave.com)\n - [Simple](https://github.com/simplefinance)\n - [Grab](https://github.com/grab)\n - [Megalytic](https://megalytic.com/)\n - [Chroma](https://www.chromatic.com)\n - [Mavens](https://github.com/mavens)\n - [Cucumber](https://cucumber.io)\n - [Genoa Telepsychiatry](https://genoatelepsychiatry.com)\n - [IBM X-Force Exchange](https://exchange.xforce.ibmcloud.com)\n - [Zendesk](https://zendesk.com/)\n - [idealo](https://www.idealo.de/)\n - [LendingHome](https://www.lendinghome.com)\n - [Diffia](https://diffia.com)\n - [MinuteMedia](https://www.minutemedia.com)\n - [Webex Teams](https://www.webex.com/team-collaboration.html)\n - [reformma](https://www.reformma.com)\n\nProjects\n----------\n - [Rheostat](https://github.com/airbnb/rheostat)\n - [React Boilerplate](https://github.com/mxstbr/react-boilerplate/tree/v3.0.0)\n - [Reactstrap](https://github.com/reactstrap/reactstrap)\n - [Recompose](https://github.com/acdlite/recompose)\n - [Reapop](https://github.com/LouisBarranqueiro/reapop)\n - [React Dates](https://github.com/airbnb/react-dates)\n - [nteract notebook](https://github.com/nteract/nteract)\n" }, { "path": "LICENSE.md", "content": "\nThe MIT License (MIT)\n\nCopyright (c) 2015 Airbnb, Inc. and contributors\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n" }, { "path": "MAINTAINERS", "content": "ljharb\nlelandrichardson\nblainekasten\nAweary\nnfcampos\n" }, { "path": "README.md", "content": "Enzyme\n=======\n\n[![Join the chat at https://gitter.im/enzymejs/enzyme](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/enzymejs/enzyme?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)\n\n[![npm Version](https://img.shields.io/npm/v/enzyme.svg)](https://www.npmjs.com/package/enzyme) [![License](https://img.shields.io/npm/l/enzyme.svg)](https://github.com/enzymejs/enzyme/blob/master/LICENSE.md) [![Build Status](https://travis-ci.org/enzymejs/enzyme.svg)](https://travis-ci.org/enzymejs/enzyme) [![Coverage Status](https://codecov.io/gh/enzymejs/enzyme/branch/master/graph/badge.svg)](https://codecov.io/gh/enzymejs/enzyme/branch/master)\n\n\nEnzyme is a JavaScript Testing utility for React that makes it easier to test your React Components' output.\nYou can also manipulate, traverse, and in some ways simulate runtime given the output.\n\nEnzyme's API is meant to be intuitive and flexible by mimicking jQuery's API for DOM manipulation\nand traversal.\n\nUpgrading from Enzyme 2.x or React < 16\n===========\n\nAre you here to check whether or not Enzyme is compatible with React 16? Are you currently using\nEnzyme 2.x? Great! Check out our [migration guide](/docs/guides/migration-from-2-to-3.md) for help\nmoving on to Enzyme v3 where React 16 is supported.\n\n### [Installation](/docs/installation/README.md)\n\nTo get started with enzyme, you can simply install it via npm. You will need to install enzyme\nalong with an Adapter corresponding to the version of react (or other UI Component library) you\nare using. For instance, if you are using enzyme with React 16, you can run:\n\n```bash\nnpm i --save-dev enzyme enzyme-adapter-react-16\n```\n\nEach adapter may have additional peer dependencies which you will need to install as well. For instance,\n`enzyme-adapter-react-16` has peer dependencies on `react` and `react-dom`.\n\nAt the moment, Enzyme has adapters that provide compatibility with `React 16.x`, `React 15.x`,\n`React 0.14.x` and `React 0.13.x`.\n\nThe following adapters are officially provided by enzyme, and have the following compatibility with\nReact:\n\n| Enzyme Adapter Package | React semver compatibility |\n| --- | --- |\n| `enzyme-adapter-react-16` | `^16.4.0-0` |\n| `enzyme-adapter-react-16.3` | `~16.3.0-0` |\n| `enzyme-adapter-react-16.2` | `~16.2` |\n| `enzyme-adapter-react-16.1` | ~16.0.0-0 || ~16.1 |\n| `enzyme-adapter-react-15` | `^15.5.0` |\n| `enzyme-adapter-react-15.4` | `15.0.0-0 - 15.4.x` |\n| `enzyme-adapter-react-14` | `^0.14.0` |\n| `enzyme-adapter-react-13` | `^0.13.0` |\n\nFinally, you need to configure enzyme to use the adapter you want it to use. To do this, you can use\nthe top level `configure(...)` API.\n\n```js\nimport Enzyme from 'enzyme';\nimport Adapter from 'enzyme-adapter-react-16';\n\nEnzyme.configure({ adapter: new Adapter() });\n```\n\n3rd Party Adapters\n=============\n\nIt is possible for the community to create additional (non-official) adapters that will make enzyme\nwork with other libraries. If you have made one and it's not included in the list below, feel free\nto make a PR to this README and add a link to it! The known 3rd party adapters are:\n\n| Adapter Package | For Library | Status |\n| --- | --- | --- |\n| [`enzyme-adapter-preact-pure`](https://github.com/preactjs/enzyme-adapter-preact-pure) | [`preact`](https://github.com/developit/preact) | (stable) |\n|[`enzyme-adapter-inferno`](https://github.com/bbc/enzyme-adapter-inferno)|[`inferno`](https://github.com/infernojs/inferno)|(work in progress)|\n\nRunning Enzyme Tests\n===========\n\nEnzyme is unopinionated regarding which test runner or assertion library you use, and should be\ncompatible with all major test runners and assertion libraries out there. The documentation and\nexamples for enzyme use [Mocha](https://mochajs.org) and [Chai](https://chaijs.com), but you\nshould be able to extrapolate to your framework of choice.\n\nIf you are interested in using enzyme with custom assertions and convenience functions for\ntesting your React components, you can consider using:\n\n* [`chai-enzyme`](https://github.com/producthunt/chai-enzyme) with Mocha/Chai.\n* [`jasmine-enzyme`](https://github.com/FormidableLabs/enzyme-matchers/tree/master/packages/jasmine-enzyme) with Jasmine.\n* [`jest-enzyme`](https://github.com/FormidableLabs/enzyme-matchers/tree/master/packages/jest-enzyme) with Jest.\n* [`should-enzyme`](https://github.com/rkotze/should-enzyme) for should.js.\n* [`expect-enzyme`](https://github.com/PsychoLlama/expect-enzyme) for expect.\n\n\n[Using Enzyme with Mocha](/docs/guides/mocha.md)\n\n[Using Enzyme with Karma](/docs/guides/karma.md)\n\n[Using Enzyme with Browserify](/docs/guides/browserify.md)\n\n[Using Enzyme with SystemJS](/docs/guides/systemjs.md)\n\n[Using Enzyme with Webpack](/docs/guides/webpack.md)\n\n[Using Enzyme with JSDOM](/docs/guides/jsdom.md)\n\n[Using Enzyme with React Native](/docs/guides/react-native.md)\n\n[Using Enzyme with Jest](/docs/guides/jest.md)\n\n[Using Enzyme with Lab](/docs/guides/lab.md)\n\n[Using Enzyme with Tape and AVA](/docs/guides/tape-ava.md)\n\nBasic Usage\n===========\n\n## [Shallow Rendering](/docs/api/shallow.md)\n\n```javascript\nimport React from 'react';\nimport { expect } from 'chai';\nimport { shallow } from 'enzyme';\nimport sinon from 'sinon';\n\nimport MyComponent from './MyComponent';\nimport Foo from './Foo';\n\ndescribe('', () => {\n it('renders three components', () => {\n const wrapper = shallow();\n expect(wrapper.find(Foo)).to.have.lengthOf(3);\n });\n\n it('renders an `.icon-star`', () => {\n const wrapper = shallow();\n expect(wrapper.find('.icon-star')).to.have.lengthOf(1);\n });\n\n it('renders children when passed in', () => {\n const wrapper = shallow((\n \n
\n \n ));\n expect(wrapper.contains(
)).to.equal(true);\n });\n\n it('simulates click events', () => {\n const onButtonClick = sinon.spy();\n const wrapper = shallow();\n wrapper.find('button').simulate('click');\n expect(onButtonClick).to.have.property('callCount', 1);\n });\n});\n```\n\nRead the full [API Documentation](/docs/api/shallow.md)\n\n\n\n## [Full DOM Rendering](/docs/api/mount.md)\n\n```javascript\nimport React from 'react';\nimport sinon from 'sinon';\nimport { expect } from 'chai';\nimport { mount } from 'enzyme';\n\nimport Foo from './Foo';\n\ndescribe('', () => {\n it('allows us to set props', () => {\n const wrapper = mount();\n expect(wrapper.props().bar).to.equal('baz');\n wrapper.setProps({ bar: 'foo' });\n expect(wrapper.props().bar).to.equal('foo');\n });\n\n it('simulates click events', () => {\n const onButtonClick = sinon.spy();\n const wrapper = mount((\n \n ));\n wrapper.find('button').simulate('click');\n expect(onButtonClick).to.have.property('callCount', 1);\n });\n\n it('calls componentDidMount', () => {\n sinon.spy(Foo.prototype, 'componentDidMount');\n const wrapper = mount();\n expect(Foo.prototype.componentDidMount).to.have.property('callCount', 1);\n Foo.prototype.componentDidMount.restore();\n });\n});\n```\n\nRead the full [API Documentation](/docs/api/mount.md)\n\n\n## [Static Rendered Markup](/docs/api/render.md)\n\n```javascript\nimport React from 'react';\nimport { expect } from 'chai';\nimport { render } from 'enzyme';\n\nimport Foo from './Foo';\n\ndescribe('', () => {\n it('renders three `.foo-bar`s', () => {\n const wrapper = render();\n expect(wrapper.find('.foo-bar')).to.have.lengthOf(3);\n });\n\n it('renders the title', () => {\n const wrapper = render();\n expect(wrapper.text()).to.contain('unique');\n });\n});\n```\n\nRead the full [API Documentation](/docs/api/render.md)\n\n### React Hooks support\n\nEnzyme supports [react hooks](https://reactjs.org/docs/hooks-intro.html) with some limitations in [`.shallow()`](https://enzymejs.github.io/enzyme/docs/api/shallow.html) due to upstream issues in React's shallow renderer:\n\n* `useEffect()` and `useLayoutEffect()` don't get called in the React shallow renderer. [Related issue](https://github.com/facebook/react/issues/15275)\n\n* `useCallback()` doesn't memoize callback in React shallow renderer. [Related issue](https://github.com/facebook/react/issues/15774)\n\n#### [`ReactTestUtils.act()`](https://reactjs.org/docs/test-utils.html#act) wrap\n\nIf you're using React 16.8+ and `.mount()`, Enzyme will wrap apis including [`.simulate()`](https://enzymejs.github.io/enzyme/docs/api/ReactWrapper/simulate.html), [`.setProps()`](https://enzymejs.github.io/enzyme/docs/api/ReactWrapper/setProps.html), [`.setContext()`](https://enzymejs.github.io/enzyme/docs/api/ReactWrapper/setContext.html), [`.invoke()`](https://enzymejs.github.io/enzyme/docs/api/ReactWrapper/invoke.html) with [`ReactTestUtils.act()`](https://reactjs.org/docs/test-utils.html#act) so you don't need to manually wrap it.\n\nA common pattern to trigger handlers with `.act()` and assert is:\n\n```javascript\nconst wrapper = mount();\nact(() => wrapper.prop('handler')());\nwrapper.update();\nexpect(/* ... */);\n```\n\nWe cannot wrap the result of `.prop()` (or `.props()`) with `.act()` in Enzyme internally since it will break the equality of the returned value.\nHowever, you could use `.invoke()` to simplify the code:\n\n```javascript\nconst wrapper = mount();\nwrapper.invoke('handler')();\nexpect(/* ... */);\n```\n\n### Future\n\n[Enzyme Future](/docs/future.md)\n\n\n### Contributing\n\nSee the [Contributors Guide](/CONTRIBUTING.md)\n\n### In the wild\n\nOrganizations and projects using `enzyme` can list themselves [here](INTHEWILD.md).\n\n### License\n\n[MIT](/LICENSE.md)\n" }, { "path": "SUMMARY.md", "content": "## Table of Contents\n\n* [Introduction](/README.md)\n* [Guides](/docs/guides.md)\n * [Migration from 2.x to 3.x](/docs/guides/migration-from-2-to-3.md)\n * [Browserify](/docs/guides/browserify.md)\n * [SystemJS](/docs/guides/systemjs.md)\n * [Webpack](/docs/guides/webpack.md)\n * [JSDOM](/docs/guides/jsdom.md)\n * [Jest](/docs/guides/jest.md)\n * [Karma](/docs/guides/karma.md)\n * [Mocha](/docs/guides/mocha.md)\n * [React Native](/docs/guides/react-native.md)\n * [Lab](/docs/guides/lab.md)\n * [Tape and AVA](/docs/guides/tape-ava.md)\n* [Installation](/docs/installation/README.md)\n * [Working with React 16.x](/docs/installation/react-16.md)\n * [Working with React 15.x](/docs/installation/react-15.md)\n * [Working with React 0.14.x](/docs/installation/react-014.md)\n * [Working with React 0.13.x](/docs/installation/react-013.md)\n* [API Reference](/docs/api/README.md)\n * [Shallow Rendering](/docs/api/shallow.md)\n * [at(index)](/docs/api/ShallowWrapper/at.md)\n * [childAt()](/docs/api/ShallowWrapper/childAt.md)\n * [children()](/docs/api/ShallowWrapper/children.md)\n * [closest(selector)](/docs/api/ShallowWrapper/closest.md)\n * [contains(nodeOrNodes)](/docs/api/ShallowWrapper/contains.md)\n * [containsAllMatchingElements(nodes)](/docs/api/ShallowWrapper/containsAllMatchingElements.md)\n * [containsAnyMatchingElements(nodes)](/docs/api/ShallowWrapper/containsAnyMatchingElements.md)\n * [containsMatchingElement(node)](/docs/api/ShallowWrapper/containsMatchingElement.md)\n * [context([key])](/docs/api/ShallowWrapper/context.md)\n * [debug()](/docs/api/ShallowWrapper/debug.md)\n * [dive()](/docs/api/ShallowWrapper/dive.md)\n * [equals(node)](/docs/api/ShallowWrapper/equals.md)\n * [every(selector)](/docs/api/ShallowWrapper/every.md)\n * [everyWhere(predicate)](/docs/api/ShallowWrapper/everyWhere.md)\n * [exists([selector])](/docs/api/ShallowWrapper/exists.md)\n * [filter(selector)](/docs/api/ShallowWrapper/filter.md)\n * [filterWhere(predicate)](/docs/api/ShallowWrapper/filterWhere.md)\n * [find(selector)](/docs/api/ShallowWrapper/find.md)\n * [findWhere(predicate)](/docs/api/ShallowWrapper/findWhere.md)\n * [first()](/docs/api/ShallowWrapper/first.md)\n * [forEach(fn)](/docs/api/ShallowWrapper/forEach.md)\n * [get(index)](/docs/api/ShallowWrapper/get.md)\n * [getWrappingComponent()](/docs/api/ShallowWrapper/getWrappingComponent.md)\n * [getElement(index)](/docs/api/ShallowWrapper/getElement.md)\n * [getElements(index)](/docs/api/ShallowWrapper/getElements.md)\n * [hasClass(className)](/docs/api/ShallowWrapper/hasClass.md)\n * [hostNodes()](/docs/api/ShallowWrapper/hostNodes.md)\n * [html()](/docs/api/ShallowWrapper/html.md)\n * [instance()](/docs/api/ShallowWrapper/instance.md)\n * [invoke(propName)](/docs/api/ShallowWrapper/invoke.md)\n * [is(selector)](/docs/api/ShallowWrapper/is.md)\n * [isEmpty()](/docs/api/ShallowWrapper/isEmpty.md)\n * [isEmptyRender()](/docs/api/ShallowWrapper/isEmptyRender.md)\n * [key()](/docs/api/ShallowWrapper/key.md)\n * [last()](/docs/api/ShallowWrapper/last.md)\n * [map(fn)](/docs/api/ShallowWrapper/map.md)\n * [matchesElement(node)](/docs/api/ShallowWrapper/matchesElement.md)\n * [name()](/docs/api/ShallowWrapper/name.md)\n * [not(selector)](/docs/api/ShallowWrapper/not.md)\n * [parent()](/docs/api/ShallowWrapper/parent.md)\n * [parents()](/docs/api/ShallowWrapper/parents.md)\n * [prop(key)](/docs/api/ShallowWrapper/prop.md)\n * [props()](/docs/api/ShallowWrapper/props.md)\n * [reduce(fn[, initialValue])](/docs/api/ShallowWrapper/reduce.md)\n * [reduceRight(fn[, initialValue])](/docs/api/ShallowWrapper/reduceRight.md)\n * [render()](/docs/api/ShallowWrapper/render.md)\n * [renderProp(key)](/docs/api/ShallowWrapper/renderProp.md)\n * [setContext(context)](/docs/api/ShallowWrapper/setContext.md)\n * [setProps(nextProps)](/docs/api/ShallowWrapper/setProps.md)\n * [setState(nextState[, callback])](/docs/api/ShallowWrapper/setState.md)\n * [shallow([options])](/docs/api/ShallowWrapper/shallow.md)\n * [simulate(event[, data])](/docs/api/ShallowWrapper/simulate.md)\n * [simulateError(error)](/docs/api/ShallowWrapper/simulateError.md)\n * [slice([begin[, end]])](/docs/api/ShallowWrapper/slice.md)\n * [some(selector)](/docs/api/ShallowWrapper/some.md)\n * [someWhere(predicate)](/docs/api/ShallowWrapper/someWhere.md)\n * [state([key])](/docs/api/ShallowWrapper/state.md)\n * [tap(intercepter)](/docs/api/ShallowWrapper/tap.md)\n * [text()](/docs/api/ShallowWrapper/text.md)\n * [type()](/docs/api/ShallowWrapper/type.md)\n * [unmount()](/docs/api/ShallowWrapper/unmount.md)\n * [update()](/docs/api/ShallowWrapper/update.md)\n * [Full DOM Rendering](/docs/api/mount.md)\n * [at(index)](/docs/api/ReactWrapper/at.md)\n * [childAt()](/docs/api/ReactWrapper/childAt.md)\n * [children()](/docs/api/ReactWrapper/children.md)\n * [contains(nodeOrNodes)](/docs/api/ReactWrapper/contains.md)\n * [containsAllMatchingElements(nodes)](/docs/api/ReactWrapper/containsAllMatchingElements.md)\n * [containsAnyMatchingElements(nodes)](/docs/api/ReactWrapper/containsAnyMatchingElements.md)\n * [containsMatchingElement(node)](/docs/api/ReactWrapper/containsMatchingElement.md)\n * [closest(selector)](/docs/api/ReactWrapper/closest.md)\n * [context([key])](/docs/api/ReactWrapper/context.md)\n * [debug()](/docs/api/ReactWrapper/debug.md)\n * [detach()](/docs/api/ReactWrapper/detach.md)\n * [equals(node)](/docs/api/ReactWrapper/equals.md)\n * [every(selector)](/docs/api/ReactWrapper/every.md)\n * [everyWhere(predicate)](/docs/api/ReactWrapper/everyWhere.md)\n * [exists([selector])](/docs/api/ReactWrapper/exists.md)\n * [filter(selector)](/docs/api/ReactWrapper/filter.md)\n * [filterWhere(predicate)](/docs/api/ReactWrapper/filterWhere.md)\n * [find(selector)](/docs/api/ReactWrapper/find.md)\n * [findWhere(predicate)](/docs/api/ReactWrapper/findWhere.md)\n * [first()](/docs/api/ReactWrapper/first.md)\n * [forEach(fn)](/docs/api/ReactWrapper/forEach.md)\n * [get(index)](/docs/api/ReactWrapper/get.md)\n * [getDOMNode()](/docs/api/ReactWrapper/getDOMNode.md)\n * [getWrappingComponent()](/docs/api/ReactWrapper/getWrappingComponent.md)\n * [hasClass(className)](/docs/api/ReactWrapper/hasClass.md)\n * [hostNodes()](/docs/api/ReactWrapper/hostNodes.md)\n * [html()](/docs/api/ReactWrapper/html.md)\n * [instance()](/docs/api/ReactWrapper/instance.md)\n * [invoke(propName)](/docs/api/ReactWrapper/invoke.md)\n * [is(selector)](/docs/api/ReactWrapper/is.md)\n * [isEmpty()](/docs/api/ReactWrapper/isEmpty.md)\n * [isEmptyRender()](/docs/api/ReactWrapper/isEmptyRender.md)\n * [key()](/docs/api/ReactWrapper/key.md)\n * [last()](/docs/api/ReactWrapper/last.md)\n * [map(fn)](/docs/api/ReactWrapper/map.md)\n * [matchesElement(node)](/docs/api/ReactWrapper/matchesElement.md)\n * [mount()](/docs/api/ReactWrapper/mount.md)\n * [name()](/docs/api/ReactWrapper/name.md)\n * [not(selector)](/docs/api/ReactWrapper/not.md)\n * [parent()](/docs/api/ReactWrapper/parent.md)\n * [parents()](/docs/api/ReactWrapper/parents.md)\n * [prop(key)](/docs/api/ReactWrapper/prop.md)\n * [props()](/docs/api/ReactWrapper/props.md)\n * [reduce(fn[, initialValue])](/docs/api/ReactWrapper/reduce.md)\n * [reduceRight(fn[, initialValue])](/docs/api/ReactWrapper/reduceRight.md)\n * [ref(refName)](/docs/api/ReactWrapper/ref.md)\n * [render()](/docs/api/ReactWrapper/render.md)\n * [renderProp(key)](/docs/api/ReactWrapper/renderProp.md)\n * [setContext(context)](/docs/api/ReactWrapper/setContext.md)\n * [setProps(nextProps[, callback])](/docs/api/ReactWrapper/setProps.md)\n * [setState(nextState[, callback])](/docs/api/ReactWrapper/setState.md)\n * [simulate(event[, data])](/docs/api/ReactWrapper/simulate.md)\n * [simulateError(error)](/docs/api/ReactWrapper/simulateError.md)\n * [slice([begin[, end]])](/docs/api/ReactWrapper/slice.md)\n * [some(selector)](/docs/api/ReactWrapper/some.md)\n * [someWhere(predicate)](/docs/api/ReactWrapper/someWhere.md)\n * [state([key])](/docs/api/ReactWrapper/state.md)\n * [tap(intercepter)](/docs/api/ReactWrapper/tap.md)\n * [text()](/docs/api/ReactWrapper/text.md)\n * [type()](/docs/api/ReactWrapper/type.md)\n * [unmount()](/docs/api/ReactWrapper/unmount.md)\n * [update()](/docs/api/ReactWrapper/update.md)\n * [Static Rendering](/docs/api/render.md)\n * [Selectors](/docs/api/selector.md)\n* [Change Log](/CHANGELOG.md)\n* [Future](/docs/future.md)\n* [Contributing Guide](/CONTRIBUTING.md)\n" }, { "path": "book.json", "content": "{\n \"gitbook\": \"3.2.2\",\n \"title\": \"Enzyme\",\n \"description\": \"React Testing\",\n \"plugins\": [\n \"edit-link\",\n \"github\",\n \"-search\",\n \"codeblock-disable-glossary\",\n \"collapsible-menu\",\n \"anchors\"\n ],\n \"pluginsConfig\": {\n \"edit-link\": {\n \"base\": \"https://github.com/enzymejs/enzyme/tree/master\",\n \"label\": \"Edit This Page\"\n },\n \"github\": {\n \"url\": \"https://github.com/enzymejs/enzyme/\"\n }\n }\n}\n" }, { "path": "docs/GLOSSARY.md", "content": "# selector\n\nA Selector in enzyme is similar to a CSS selector, but can be a number of other things as well in\norder to easily specify a criteria by which you want to find nodes in an enzyme wrapper. See the\n[Selector page](/docs/api/selector.md) for more information.\n\n# wrapper\n\nA wrapper refers to the enzyme wrapper class that provides the API.\n\n\n# predicate\n\nA function that returns true or false\n" }, { "path": "docs/api/README.md", "content": "# API Reference\n\n\n\n### [Shallow Rendering](shallow.md)\n\n```jsx\nimport { shallow } from 'enzyme';\n\nconst wrapper = shallow();\n// ...\n```\n\n\n### [Full Rendering](mount.md)\n\n```jsx\nimport { mount } from 'enzyme';\n\nconst wrapper = mount();\n// ...\n```\n\n\n### [Static Rendering](render.md)\n\n```jsx\nimport { render } from 'enzyme';\n\nconst wrapper = render();\n// ...\n```\n" }, { "path": "docs/api/ReactWrapper/at.md", "content": "# `.at(index) => ReactWrapper`\n\nReturns a wrapper around the node at a given index of the current wrapper.\n\n\n#### Arguments\n\n1. `index` (`Number`): A zero-based integer indicating which node to retrieve.\n\n\n\n#### Returns\n\n`ReactWrapper`: A new wrapper that wraps the retrieved node.\n\n\n\n#### Examples\n\n```jsx\nconst wrapper = mount();\nexpect(wrapper.find(Foo).at(0).props().foo).to.equal('bar');\n```\n\n\n\n#### Related Methods\n\n- [`.get(index) => ReactElement`](get.md) - same, but returns the React node itself, with no wrapper.\n- [`.first() => ReactWrapper`](first.md) - same as at(0)\n- [`.last() => ReactWrapper`](last.md)\n" }, { "path": "docs/api/ReactWrapper/childAt.md", "content": "# `.childAt(index) => ReactWrapper`\n\nReturns a new wrapper with child at the specified index.\n\n#### Arguments\n\n1. `index` (`number`): A zero-based integer indicating which node to retrieve.\n\n\n#### Returns\n\n`ReactWrapper`: A new wrapper that wraps the resulting node.\n\n\n\n#### Examples\n\n```jsx\nconst wrapper = mount();\nexpect(wrapper.find('ul').childAt(0).type()).to.equal('li');\n```\n\n#### Related Methods\n\n- [`.parents([selector]) => ReactWrapper`](parents.md)\n- [`.parent() => ReactWrapper`](parent.md)\n- [`.closest(selector) => ReactWrapper`](closest.md)\n- [`.children([selector]) => ReactWrapper`](children.md)\n" }, { "path": "docs/api/ReactWrapper/children.md", "content": "# `.children([selector]) => ReactWrapper`\n\nReturns a new wrapper with all of the children of the node(s) in the current wrapper. Optionally, a\nselector can be provided and it will filter the children by this selector\n\n\n#### Arguments\n\n1. `selector` ([`EnzymeSelector`](../selector.md) [optional]): A selector to filter the children by.\n\n\n#### Returns\n\n`ReactWrapper`: A new wrapper that wraps the resulting nodes.\n\n\n\n#### Examples\n\n```jsx\nconst wrapper = mount();\nexpect(wrapper.find('ul').children()).to.have.lengthOf(items.length);\n```\n\n#### Related Methods\n\n- [`.parents([selector]) => ReactWrapper`](parents.md)\n- [`.parent() => ReactWrapper`](parent.md)\n- [`.closest(selector) => ReactWrapper`](closest.md)\n" }, { "path": "docs/api/ReactWrapper/closest.md", "content": "# `.closest(selector) => ReactWrapper`\n\nReturns a wrapper of the first element that matches the selector by traversing up through the\nwrapped node's ancestors in the tree, starting with itself. It must be a single-node wrapper.\n\n#### Arguments\n\n1. `selector` ([`EnzymeSelector`](../selector.md)): The selector to match.\n\n#### Returns\n\n`ReactWrapper`: A new wrapper that wraps the resulting node.\n\n\n\n#### Examples\n\n```jsx\nconst wrapper = mount();\nexpect(wrapper.find(Foo).closest('.bar')).to.have.lengthOf(1);\n```\n\n#### Related Methods\n\n- [`.children([selector]) => ReactWrapper`](children.md)\n- [`.parent() => ReactWrapper`](parent.md)\n- [`.parents([selector]) => ReactWrapper`](parents.md)\n" }, { "path": "docs/api/ReactWrapper/contains.md", "content": "# `.contains(nodeOrNodes) => Boolean`\n\nReturns whether or not all given react elements match elements in the render tree.\nIt will determine if an element in the wrapper matches the expected element by checking if the expected element has the same props as the wrapper's element and share the same values.\n\n\n#### Arguments\n\n1. `nodeOrNodes` (`ReactElement|Array`): The node or array of nodes whose presence you are detecting in the current instance's\nrender tree.\n\n\n\n#### Returns\n\n`Boolean`: whether or not the current wrapper has nodes anywhere in its render tree that match\nthe ones passed in.\n\n\n\n#### Example\n\n\n```jsx\nconst wrapper = mount((\n
\n
Hello
\n
\n));\n\nexpect(wrapper.contains(
Hello
)).to.equal(true);\n\nexpect(wrapper.contains(
Hello
)).to.equal(false);\nexpect(wrapper.contains(
Hello
)).to.equal(false);\nexpect(wrapper.contains(
Hello
)).to.equal(false);\nexpect(wrapper.contains(
)).to.equal(false);\n```\n\n```jsx\nconst wrapper = mount((\n
\n Hello\n
Goodbye
\n Again\n
\n));\n\nexpect(wrapper.contains([\n Hello,\n
Goodbye
,\n])).to.equal(true);\n\nexpect(wrapper.contains([\n Hello,\n
World
,\n])).to.equal(false);\n```\n\n\n#### Common Gotchas\n\n- `.contains()` expects a ReactElement, not a selector (like many other methods). Make sure that\nwhen you are calling it you are calling it with a ReactElement or a JSX expression.\n- Keep in mind that this method determines equality based on the equality of the node's children as\nwell.\n- Every attribute of the wrapped element must be matched by the element you're checking. To permit (and ignore) additional attributes on the wrapped element, use containsMatchingElement() instead.\n" }, { "path": "docs/api/ReactWrapper/containsAllMatchingElements.md", "content": "# `.containsAllMatchingElements(patternNodes) => Boolean`\n\nReturns whether or not all of the given react elements in `patternNodes` match an element in the wrapper's render tree. Every single element of `patternNodes` must be matched one or more times. Matching follows the rules for `containsMatchingElement`.\n\n\n#### Arguments\n\n1. `patternNodes` (`Array`): The array of nodes whose presence you are detecting in the current instance's\nrender tree.\n\n\n#### Returns\n\n`Boolean`: whether or not the current wrapper has nodes anywhere in its render tree that looks\nlike the nodes passed in.\n\n\n#### Example\n\n\n```jsx\nconst style = { fontSize: 13 };\nconst wrapper = mount((\n
\n Hello\n
Goodbye
\n Again\n
\n));\n\nexpect(wrapper.containsAllMatchingElements([\n Hello,\n
Goodbye
,\n])).to.equal(true);\n```\n\n\n#### Common Gotchas\n\n- `.containsAllMatchingElements()` expects an array of ReactElement, not a selector (like many other methods). Make sure that\nwhen you are calling it you are calling it with an array of ReactElement or a JSX expression.\n- Keep in mind that this method determines matching based on the matching of the node's children as\nwell.\n\n\n#### Related Methods\n\n- [`.matchesElement() => ReactWrapper`](matchesElement.md) - rules for matching each node\n- [`.containsMatchingElement() => ReactWrapper`](containsMatchingElement.md) - rules for matching whole wrapper\n- [`.containsAnyMatchingElements() => ReactWrapper`](containsAnyMatchingElements.md) - must match at least one in patternNodes\n" }, { "path": "docs/api/ReactWrapper/containsAnyMatchingElements.md", "content": "# `.containsAnyMatchingElements(patternNodes) => Boolean`\n\nReturns whether or not at least one of the given react elements in `patternNodes` matches an element in the wrapper's render tree. One or more elements of `patternNodes` must be matched one or more times. Matching follows the rules for `containsMatchingElement`.\n\n\n#### Arguments\n\n1. `patternNodes` (`Array`): The array of nodes whose presence you are detecting in the current instance's\nrender tree.\n\n\n#### Returns\n\n`Boolean`: whether or not the current wrapper has a node anywhere in its render tree that looks\nlike one of the array passed in.\n\n\n#### Example\n\n\n```jsx\nconst style = { fontSize: 13 };\nconst wrapper = mount((\n
\n Hello\n
Goodbye
\n Again\n
\n));\n\nexpect(wrapper.containsAnyMatchingElements([\n Bonjour,\n
Goodbye
,\n])).to.equal(true);\n```\n\n\n#### Common Gotchas\n\n- `.containsAnyMatchingElements()` expects an array of ReactElement, not a selector (like many other methods). Make sure that\nwhen you are calling it you are calling it with an array ReactElement or a JSX expression.\n- Keep in mind that this method determines equality based on the equality of the node's children as\nwell.\n\n\n#### Related Methods\n\n- [`.matchesElement() => ReactWrapper`](matchesElement.md) - rules for matching each node\n- [`.containsMatchingElement() => ReactWrapper`](containsMatchingElement.md) - rules for matching whole wrapper\n- [`.containsAllMatchingElements() => ReactWrapper`](containsAllMatchingElements.md) - must match all nodes in patternNodes\n" }, { "path": "docs/api/ReactWrapper/containsMatchingElement.md", "content": "# `.containsMatchingElement(patternNode) => Boolean`\n\nReturns whether or not a `patternNode` react element matches any element in the render tree.\n* the matches can happen anywhere in the wrapper's contents\n* the wrapper can contain more than one node; all are searched\n\nOtherwise, the match follows the same rules as `matchesElement`.\n\n\n#### Arguments\n\n1. `patternNode` (`ReactElement`): The node whose presence you are detecting in the current instance's\nrender tree.\n\n\n#### Returns\n\n`Boolean`: whether or not the current wrapper has a node anywhere in its render tree that matches\nthe one passed in.\n\n\n\n#### Example\n\n\n```jsx\nconst wrapper = mount((\n
\n
Hello
\n
\n));\n\nexpect(wrapper.containsMatchingElement(
Hello
)).to.equal(true);\nexpect(wrapper.containsMatchingElement(
Hello
)).to.equal(true);\n\nexpect(wrapper.containsMatchingElement(
Hello
)).to.equal(false);\nexpect(wrapper.containsMatchingElement(
Hello
)).to.equal(false);\nexpect(wrapper.containsMatchingElement(
)).to.equal(false);\n```\n\n#### Common Gotchas\n\n- `.containsMatchingElement()` expects a ReactElement, not a selector (like many other methods). Make sure that\nwhen you are calling it you are calling it with a ReactElement or a JSX expression.\n- Keep in mind that this method determines equality based on the equality of the node's children as\nwell.\n\n\n#### Related Methods\n\n- [`.containsAllMatchingElements() => ReactWrapper`](containsAllMatchingElements.md) - must match all nodes in patternNodes\n- [`.containsAnyMatchingElements() => ReactWrapper`](containsAnyMatchingElements.md) - must match at least one in patternNodes\n" }, { "path": "docs/api/ReactWrapper/context.md", "content": "# `.context([key]) => Any`\n\nReturns the context hash for the root node of the wrapper. Optionally pass in a prop name and it\nwill return just that value.\n\n\n#### Arguments\n\n1. `key` (`String` [optional]): If provided, the return value will be the `this.context[key]` of the\nroot component instance.\n\n\n\n#### Example\n\n\n```jsx\nconst wrapper = mount(\n ,\n { context: { foo: 10 } },\n);\n\nexpect(wrapper.context().foo).to.equal(10);\nexpect(wrapper.context('foo')).to.equal(10);\n```\n\n\n#### Related Methods\n\n- [`.state([key]) => Any`](state.md)\n- [`.props() => Object`](props.md)\n- [`.prop(key) => Any`](prop.md)\n" }, { "path": "docs/api/ReactWrapper/debug.md", "content": "# `.debug([options]) => String`\n\nReturns an HTML-like string of the wrapper for debugging purposes. Useful to print out to the\nconsole when tests are not passing when you expect them to.\n\n\n#### Arguments\n\n`options` (`Object` [optional]):\n- `options.ignoreProps`: (`Boolean` [optional]): Whether props should be omitted in the resulting string. Props are included by default.\n- `options.verbose`: (`Boolean` [optional]): Whether arrays and objects passed as props should be verbosely printed.\n\n#### Returns\n\n`String`: The resulting string.\n\n\n\n#### Examples\n\nSay we have the following components:\n```jsx\nfunction Foo() {\n return (\n
\n Foo\n
\n );\n}\n\nfunction Bar() {\n return (\n
\n Non-Foo\n \n
\n );\n}\n```\n\nIn this case, running:\n```jsx\nconsole.log(mount().debug());\n```\n\nWould output the following to the console:\n\n```text\n\n
\n \n Non-Foo\n \n \n
\n \n Foo\n \n
\n \n
\n\n```\n\nLikewise, running:\n\n```jsx\nconsole.log(mount().find(Foo).debug());\n```\nWould output the following to the console:\n\n```text\n\n
\n \n Foo\n \n
\n\n```\nand:\n```jsx\nconsole.log(mount().find(Foo).debug({ ignoreProps: true }));\n```\nWould output the following to the console:\n\n```text\n\n
\n \n Foo\n \n
\n\n```\n\nand:\n```jsx\nconsole.log(mount().find(Foo).debug({ verbose: true }));\n```\nWould output the following to the console:\n\n```text\n\n
\n \n Foo\n \n
\n\n```\n" }, { "path": "docs/api/ReactWrapper/detach.md", "content": "# `.detach() => void`\n\nDetaches the react tree from the DOM. Runs `ReactDOM.unmountComponentAtNode()` under the hood.\n\nThis method will most commonly be used as a \"cleanup\" method if you decide to use the\n`attachTo` or `hydrateIn` option in `mount(node, options)`.\n\nThe method is intentionally not \"fluent\" (in that it doesn't return `this`) because you should\nnot be doing anything with this wrapper after this method is called.\n\nUsing `attachTo`/`hydrateIn` is not generally recommended unless it is absolutely necessary to test\nsomething. It is your responsibility to clean up after yourself at the end of the test if you do\ndecide to use it, though.\n\n\n#### Examples\n\n\nWith the `attachTo` option, you can mount components to attached DOM elements:\n```jsx\n// render a component directly into document.body\nconst wrapper = mount(, { attachTo: document.body });\n\n// Or, with the `hydrateIn` option, you can mount components on top of existing DOM elements:\n// hydrate a component directly onto document.body\nconst hydratedWrapper = mount(, { hydrateIn: document.body });\n\n// we can see that the component is rendered into the document\nexpect(wrapper.find('.in-bar')).to.have.lengthOf(1);\nexpect(document.body.childNodes).to.have.lengthOf(1);\n\n// detach it to clean up after yourself\nwrapper.detach();\n\n// now we can see that\nexpect(document.body.childNodes).to.have.lengthOf(0);\n```\n\nSimilarly, if you want to create some one-off elements for your test to mount into:\n```jsx\n// create a div in the document to mount into\nconst div = global.document.createElement('div');\nglobal.document.body.appendChild(div);\n\n// div is empty. body has the div attached.\nexpect(document.body.childNodes).to.have.lengthOf(1);\nexpect(div.childNodes).to.have.lengthOf(0);\n\n// mount a component passing div into the `attachTo` option\nconst wrapper = mount(, { attachTo: div });\n// or, mount a component passing div into the `hydrateIn` option\nconst hydratedWrapper = mount(, { hydrateIn: div });\n\n// we can see now the component is rendered into the document\nexpect(wrapper.find('.in-foo')).to.have.lengthOf(1);\nexpect(document.body.childNodes).to.have.lengthOf(1);\nexpect(div.childNodes).to.have.lengthOf(1);\n\n// call detach to clean up\nwrapper.detach();\n\n// div is now empty, but still attached to the document\nexpect(document.body.childNodes).to.have.lengthOf(1);\nexpect(div.childNodes).to.have.lengthOf(0);\n\n// remove div if you want\nglobal.document.body.removeChild(div);\n\nexpect(document.body.childNodes).to.have.lengthOf(0);\nexpect(div.childNodes).to.have.lengthOf(0);\n```\n" }, { "path": "docs/api/ReactWrapper/equals.md", "content": "# `.equals(node) => Boolean`\n\nReturns whether or not the current wrapper root node render tree looks like the one passed in.\n\n\n#### Arguments\n\n1. `node` (`ReactElement`): The node whose presence you are detecting in the current instance's\nrender tree.\n\n\n\n#### Returns\n\n`Boolean`: whether or not the current wrapper has a node anywhere in it's render tree that looks\nlike the one passed in.\n\n\n\n#### Example\n\n\n```jsx\nfunction MyComponent() {\n return
;\n}\n\nconst wrapper = mount().childAt(0);\nexpect(wrapper.equals(
)).to.equal(true);\n```\n\n\n#### Common Gotchas\n\n- `.equals()` expects a ReactElement, not a selector (like many other methods). Make sure that\nwhen you are calling it you are calling it with a ReactElement or a JSX expression.\n- Keep in mind that this method determines equality based on the equality of the node's children as\nwell.\n- Following React's behavior, `.equals()` ignores properties whose values are `undefined`.\n" }, { "path": "docs/api/ReactWrapper/every.md", "content": "# `.every(selector) => Boolean`\n\nReturns whether or not all of the nodes in the wrapper match the provided selector.\n\n\n#### Arguments\n\n1. `selector` ([`EnzymeSelector`](../selector.md)): The selector to match.\n\n\n\n#### Returns\n\n`Boolean`: True if every node in the current wrapper matched the provided selector.\n\n\n\n#### Examples\n\n```jsx\nconst wrapper = mount((\n
\n
\n
\n
\n
\n));\nexpect(wrapper.find('.foo').every('.foo')).to.equal(true);\nexpect(wrapper.find('.foo').every('.qoo')).to.equal(false);\nexpect(wrapper.find('.foo').every('.bar')).to.equal(false);\n```\n\n#### Related Methods\n\n- [`.someWhere(predicate) => Boolean`](someWhere.md)\n- [`.everyWhere(predicate) => Boolean`](everyWhere.md)\n" }, { "path": "docs/api/ReactWrapper/everyWhere.md", "content": "# `.everyWhere(fn) => Boolean`\n\nReturns whether or not all of the nodes in the wrapper pass the provided predicate function.\n\n\n#### Arguments\n\n1. `predicate` (`ReactWrapper => Boolean`): A predicate function to match the nodes.\n\n\n\n#### Returns\n\n`Boolean`: True if every node in the current wrapper passed the predicate function.\n\n\n\n#### Example\n\n```jsx\nconst wrapper = mount((\n
\n
\n
\n
\n
\n));\nexpect(wrapper.find('.foo').everyWhere((n) => n.hasClass('foo'))).to.equal(true);\nexpect(wrapper.find('.foo').everyWhere((n) => n.hasClass('qoo'))).to.equal(false);\nexpect(wrapper.find('.foo').everyWhere((n) => n.hasClass('bar'))).to.equal(false);\n```\n\n\n#### Related Methods\n\n- [`.some(selector) => Boolean`](some.md)\n- [`.every(selector) => Boolean`](every.md)\n\n" }, { "path": "docs/api/ReactWrapper/exists.md", "content": "# `.exists([selector]) => Boolean`\n\nReturns whether or not any nodes exist in the wrapper. Or, if a selector is passed in, whether that selector has any matches in the wrapper.\n\n\n\n#### Arguments\n\n1. `selector` ([`EnzymeSelector`](../selector.md) [optional]): The selector to check existence for.\n\n\n\n#### Returns\n\n`Boolean`: whether or not any nodes are on the list, or the selector had any matches.\n\n\n\n#### Example\n\n\n```jsx\nconst wrapper = mount(
);\nexpect(wrapper.exists('.some-class')).to.equal(true);\nexpect(wrapper.find('.other-class').exists()).to.equal(false);\n```\n" }, { "path": "docs/api/ReactWrapper/filter.md", "content": "# `.filter(selector) => ReactWrapper`\n\nReturns a new wrapper with only the nodes of the current wrapper that match the provided selector.\n\n\n#### Arguments\n\n1. `selector` ([`EnzymeSelector`](../selector.md)): The selector to match.\n\n\n\n#### Returns\n\n`ReactWrapper`: A new wrapper that wraps the filtered nodes.\n\n\n\n#### Examples\n\n```jsx\nconst wrapper = mount();\nexpect(wrapper.find('.foo').filter('.bar')).to.have.lengthOf(1);\n```\n\n#### Related Methods\n\n- [`.filterWhere(predicate) => ReactWrapper`](filterWhere.md)\n" }, { "path": "docs/api/ReactWrapper/filterWhere.md", "content": "# `.filterWhere(fn) => ReactWrapper`\n\nReturns a new wrapper with only the nodes of the current wrapper that, when passed into the\nprovided predicate function, return true.\n\n\n#### Arguments\n\n1. `predicate` (`ReactWrapper => Boolean`): A predicate function that is passed a wrapped node.\n\n\n\n#### Returns\n\n`ReactWrapper`: A new wrapper that wraps the filtered nodes.\n\n\n\n#### Example\n\n```jsx\nconst wrapper = mount();\nconst complexComponents = wrapper.find('.foo').filterWhere((n) => typeof n.type() !== 'string');\nexpect(complexComponents).to.have.lengthOf(4);\n```\n\n\n#### Related Methods\n\n- [`.filter(selector) => ReactWrapper`](filter.md)\n" }, { "path": "docs/api/ReactWrapper/find.md", "content": "# `.find(selector) => ReactWrapper`\n\nFinds every node in the render tree of the current wrapper that matches the provided selector.\n\n\n#### Arguments\n\n1. `selector` ([`EnzymeSelector`](../selector.md)): The selector to match.\n\n\n\n#### Returns\n\n`ReactWrapper`: A new wrapper that wraps the found nodes.\n\n\n\n#### Examples\n\nCSS Selectors:\n```jsx\nconst wrapper = mount();\nexpect(wrapper.find('.foo')).to.have.lengthOf(1);\nexpect(wrapper.find('.bar')).to.have.lengthOf(3);\n\n// compound selector\nexpect(wrapper.find('div.some-class')).to.have.lengthOf(3);\n\n// CSS id selector\nexpect(wrapper.find('#foo')).to.have.lengthOf(1);\n\n// property selector\nexpect(wrapper.find('[htmlFor=\"checkbox\"]')).to.have.lengthOf(1);\n```\n\nComponent Constructors:\n```jsx\nimport Foo from '../components/Foo';\n\nconst wrapper = mount();\nexpect(wrapper.find(Foo)).to.have.lengthOf(1);\n```\n\nComponent Display Name:\n```jsx\nconst wrapper = mount();\nexpect(wrapper.find('Foo')).to.have.lengthOf(1);\n```\n\nObject Property Selector:\n```jsx\nconst wrapper = mount();\nexpect(wrapper.find({ prop: 'value' })).to.have.lengthOf(1);\n```\n\n#### Related Methods\n\n- [`.findWhere(predicate) => ReactWrapper`](findWhere.md)\n" }, { "path": "docs/api/ReactWrapper/findWhere.md", "content": "# `.findWhere(fn) => ReactWrapper`\n\nFinds every node in the render tree that returns true for the provided predicate function.\n\n\n#### Arguments\n\n1. `predicate` (`ReactWrapper => Boolean`): A predicate function called with the passed in wrapped\nnodes.\n\n\n\n#### Returns\n\n`ReactWrapper`: A new wrapper that wraps the found nodes.\n\n\n\n#### Example\n\n```jsx\nconst wrapper = mount();\nconst complexComponents = wrapper.findWhere((n) => typeof n.type() !== 'string');\nexpect(complexComponents).to.have.lengthOf(8);\n```\n\n\n#### Related Methods\n\n- [`.find(selector) => ReactWrapper`](find.md)\n" }, { "path": "docs/api/ReactWrapper/first.md", "content": "# `.first() => ReactWrapper`\n\nReduce the set of matched nodes to the first in the set, just like `.at(0)`.\n\n\n#### Returns\n\n`ReactWrapper`: A new wrapper that wraps the first node in the set.\n\n\n#### Examples\n\n```jsx\nconst wrapper = mount();\nexpect(wrapper.find(Foo).first().props().foo).to.equal('bar');\n```\n\n\n#### Related Methods\n\n- [`.at(index) => ReactWrapper`](at.md) - retrieve a wrapper node at given index\n- [`.last() => ReactWrapper`](last.md)\n" }, { "path": "docs/api/ReactWrapper/forEach.md", "content": "# `.forEach(fn) => Self`\n\nIterates through each node of the current wrapper and executes the provided function with a\nwrapper around the corresponding node passed in as the first argument.\n\n\n#### Arguments\n\n1. `fn` (`Function ( ReactWrapper node, Number index )`): A callback to be run for every node in the collection.\nShould expect a ReactWrapper as the first argument, and will be run with a context of the original\ninstance.\n\n\n\n#### Returns\n\n`ReactWrapper`: Returns itself.\n\n\n\n#### Example\n\n```jsx\nconst wrapper = mount((\n
\n
\n
\n
\n
\n));\n\nwrapper.find('.foo').forEach((node) => {\n expect(node.hasClass('foo')).to.equal(true);\n});\n```\n\n\n#### Related Methods\n\n- [`.map(fn) => ReactWrapper`](map.md)\n" }, { "path": "docs/api/ReactWrapper/get.md", "content": "# `.get(index) => ReactElement`\n\nReturns the node at a given index of the current wrapper.\n\n\n#### Arguments\n\n1. `index` (`Number`): A zero-based integer indicating which node to retrieve.\n\n\n#### Returns\n\n`ReactElement`: The retrieved node.\n\n\n#### Examples\n\n```jsx\nconst wrapper = mount();\nexpect(wrapper.find(Foo).get(0).props.foo).to.equal('bar');\n```\n\n\n#### Related Methods\n\n- [`.at(index) => ReactWrapper`](at.md) - same, but returns the React node in a single-node wrapper.\n" }, { "path": "docs/api/ReactWrapper/getDOMNode.md", "content": "# `.getDOMNode() => DOMComponent`\n\nReturns the outer most DOMComponent of the current wrapper.\n\nNotes:\n- can only be called on a wrapper of a single node.\n- will raise if called on a wrapper of a stateless functional component.\n\n\n#### Returns\n\n`DOMComponent`: The retrieved DOM component.\n\n\n\n#### Examples\n\n```jsx\nconst wrapper = mount();\nexpect(wrapper.getDOMNode()).to.have.property('className');\n```\n" }, { "path": "docs/api/ReactWrapper/getElement.md", "content": "# `.getElement() => ReactElement`\n\nReturns the wrapped ReactElement.\n\nIf the current wrapper is wrapping the root component, returns the root component's latest render output.\n\n\n#### Returns\n\n`ReactElement`: The retrieved ReactElement.\n\n\n\n#### Examples\n\n```jsx\nconst element = (\n
\n \n \n
\n);\n\nfunction MyComponent() {\n return element;\n}\n\nconst wrapper = mount();\nexpect(wrapper.getElement()).to.equal(element);\n```\n\n\n\n#### Related Methods\n\n- [`.getElements() => Array`](getElements.md)\n" }, { "path": "docs/api/ReactWrapper/getElements.md", "content": "# `.getElements() => Array`\n\nReturns the wrapped ReactElements\n\nIf the current wrapper is wrapping the root component, returns the root component's latest render output wrapped in an array.\n\n\n#### Returns\n\n`Array`: The retrieved ReactElements.\n\n\n\n#### Examples\n\n```jsx\nconst one = ;\nconst two = ;\n\nfunction Test() {\n return (\n
\n {one}\n {two}\n
\n );\n}\n\nconst wrapper = mount();\nexpect(wrapper.find('span').getElements()).to.deep.equal([one, two]);\n```\n\n\n\n#### Related Methods\n\n- [`.getElement() => ReactElement`](getElement.md)\n" }, { "path": "docs/api/ReactWrapper/getWrappingComponent.md", "content": "# `.getWrappingComponent() => ReactWrapper`\n\nIf a `wrappingComponent` was passed in `options`, this methods returns a `ReactWrapper` around the rendered `wrappingComponent`. This `ReactWrapper` can be used to update the `wrappingComponent`'s props, state, etc.\n\n\n#### Returns\n\n`ReactWrapper`: A `ReactWrapper` around the rendered `wrappingComponent`\n\n\n\n#### Examples\n\n```jsx\nimport { Provider } from 'react-redux';\nimport { Router } from 'react-router';\nimport store from './my/app/store';\nimport mockStore from './my/app/mockStore';\n\nfunction MyProvider(props) {\n const { children, customStore } = props;\n\n return (\n \n \n {children}\n \n \n );\n}\nMyProvider.propTypes = {\n children: PropTypes.node,\n customStore: PropTypes.shape({}),\n};\nMyProvider.defaultProps = {\n children: null,\n customStore: null,\n};\n\nconst wrapper = mount(, {\n wrappingComponent: MyProvider,\n});\nconst provider = wrapper.getWrappingComponent();\nprovider.setProps({ customStore: mockStore });\n```\n" }, { "path": "docs/api/ReactWrapper/hasClass.md", "content": "# `.hasClass(className) => Boolean`\n\nReturns whether or not the wrapped node has a `className` prop including the passed in class name. It must be a single-node wrapper.\n\n\n#### Arguments\n\n1. `className` (`String` | `RegExp`): A single class name or a regex expression.\n\n\n#### Returns\n\n`Boolean`: whether or not the wrapped node has found the class name.\n\n\n#### Examples\n\n\n```jsx\nconst wrapper = mount();\nexpect(wrapper.find('.my-button').hasClass('disabled')).to.equal(true);\n```\n\n```jsx\n// Searching using RegExp works fine when classes were injected by a jss decorator\nconst wrapper = mount();\nexpect(wrapper.find('.my-button').hasClass(/(ComponentName)-(other)-(\\d+)/)).to.equal(true);\n```\n\n### Common Gotchas\n\n- `.hasClass()` expects a class name, NOT a CSS selector. `.hasClass('.foo')` should be\n`.hasClass('foo')`\n" }, { "path": "docs/api/ReactWrapper/hostNodes.md", "content": "# `.hostNodes() => ReactWrapper`\n\nReturns a new wrapper with only host nodes.\nWhen using `react-dom`, host nodes are HTML elements rather than custom React components, e.g. `
` versus ``.\n\n\n#### Returns\n\n`ReactWrapper`: A new wrapper that wraps the filtered nodes.\n\n\n#### Examples\n\nThe following code takes a wrapper with two nodes, one a `` React component, and the other a ``, and filters out the React component.\n\n```jsx\nconst wrapper = mount((\n
\n \n \n
\n));\nconst twoNodes = wrapper.find('.foo');\nexpect(twoNodes.hostNodes()).to.have.lengthOf(1);\n```\n" }, { "path": "docs/api/ReactWrapper/html.md", "content": "# `.html() => String`\n\nReturns a string of the rendered HTML markup of the current render tree. See also [`.debug()`](debug.md)\n\nNote: can only be called on a wrapper of a single node.\n\n\n#### Returns\n\n`String`: The resulting HTML string\n\n\n\n#### Examples\n\n```jsx\nfunction Foo() {\n return (
);\n}\n```\n\n```jsx\nfunction Bar() {\n return (\n
\n \n
\n );\n}\n```\n\n```jsx\nconst wrapper = mount();\nexpect(wrapper.html()).to.equal('
');\nexpect(wrapper.find(Foo).html()).to.equal('
');\n```\n\n```jsx\nconst wrapper = mount(
important
);\nexpect(wrapper.html()).to.equal('
important
');\n```\n\n\n#### Related Methods\n\n[`.text() => String`](text.md)\n" }, { "path": "docs/api/ReactWrapper/instance.md", "content": "# `.instance() => ReactComponent`\n\nReturns the single-node wrapper's node's underlying class instance; `this` in its methods. It must be a single-node wrapper.\n\nNOTE: can only be called on a wrapper instance that is also the root instance. With React `16` and above, `instance()` returns `null` for functional components, regardless of [hooks](https://reactjs.org/docs/hooks-intro.html) usage.\n\n#### Returns\n\n`ReactComponent|DOMComponent`: The retrieved instance.\n\n#### Example\n\n\n\n```jsx\nfunction SFC() {\n return
MyFunction
;\n}\n\nclass Stateful extends React.Component {\n render() {\n return
MyClass
;\n }\n}\n```\n\n#### React 16.x\n\n```jsx\ntest('wrapper instance is null', () => {\n const wrapper = mount();\n const instance = wrapper.instance();\n\n expect(instance).to.equal(null);\n});\n\ntest('wrapper instance is not null', () => {\n const wrapper = mount();\n const instance = wrapper.instance();\n\n expect(instance).to.be.instanceOf(MyCStatefullass);\n});\n```\n\n#### React 15.x\n\n```jsx\ntest('wrapper instance is not null', () => {\n const wrapper = mount();\n const instance = wrapper.instance();\n\n expect(instance).to.be.instanceOf(SFC);\n});\n\ntest('wrapper instance is not null', () => {\n const wrapper = mount();\n const instance = wrapper.instance();\n\n expect(instance).to.be.instanceOf(Stateful);\n});\n```\n" }, { "path": "docs/api/ReactWrapper/invoke.md", "content": "# `.invoke(propName)(...args) => Any`\n\nInvokes a function prop.\nNote that in React 16.8+, `.invoke` will wrap your handler with [`ReactTestUtils.act`](https://reactjs.org/docs/test-utils.html#act) and call `.update()` automatically.\n\n#### Arguments\n\n1. `propName` (`String`): The function prop that is invoked\n2. `...args` (`Any` [optional]): Arguments that is passed to the prop function\n\n\n\n#### Returns\n\n`Any`: Returns the value from the prop function\n\n#### Example\n\n```jsx\nclass Foo extends React.Component {\n loadData() {\n return fetch();\n }\n\n render() {\n return (\n
\n this.loadData()}\n >\n Load more\n \n
\n );\n }\n}\nconst wrapper = mount();\nwrapper.find('button').invoke('onClick')().then(() => {\n // expect()\n});\n```\n" }, { "path": "docs/api/ReactWrapper/is.md", "content": "# `.is(selector) => Boolean`\n\nReturns whether or not the single wrapped node matches the provided selector. It must be a single-node wrapper.\n\n\n#### Arguments\n\n1. `selector` ([`EnzymeSelector`](../selector.md)): The selector to match.\n\n\n#### Returns\n\n`Boolean`: whether or not the wrapped node matches the provided selector.\n\n\n#### Example\n\n\n```jsx\nconst wrapper = mount(
);\nexpect(wrapper.is('.some-class')).to.equal(true);\n```\n" }, { "path": "docs/api/ReactWrapper/isEmpty.md", "content": "# `.isEmpty() => Boolean`\n**Deprecated**: Use [`.exists()`](exists.md) instead.\n\nReturns whether or not the wrapper is empty.\n\n\n#### Returns\n\n`Boolean`: whether or not the wrapper is empty.\n\n\n#### Example\n\n\n```jsx\nconst wrapper = mount(
);\nexpect(wrapper.find('.other-class').isEmpty()).to.equal(true);\n```\n" }, { "path": "docs/api/ReactWrapper/isEmptyRender.md", "content": "# `.isEmptyRender() => Boolean`\n\nReturns whether or not the wrapper would ultimately render only the allowed falsy values: `false` or `null`.\n\n#### Returns\n\n`Boolean`: whether the return is falsy\n\n#### Example\n\n```jsx\nfunction Foo() {\n return null;\n}\n\nconst wrapper = mount();\nexpect(wrapper.isEmptyRender()).to.equal(true);\n```\n" }, { "path": "docs/api/ReactWrapper/key.md", "content": "# `.key() => String`\n\nReturns the key value for the node of the current wrapper. It must be a single-node wrapper.\n\n#### Example\n\n\n```jsx\nconst wrapper = mount((\n
    \n {['foo', 'bar'].map((s) =>
  • {s}
    • )}\n
\n)).find('li');\nexpect(wrapper.at(0).key()).to.equal('foo');\nexpect(wrapper.at(1).key()).to.equal('bar');\n```\n" }, { "path": "docs/api/ReactWrapper/last.md", "content": "# `.last() => ReactWrapper`\n\nReduce the set of matched nodes to the last in the set, just like `.at(length - 1)`.\n\n\n#### Returns\n\n`ReactWrapper`: A new wrapper that wraps the last node in the set.\n\n\n#### Examples\n\n```jsx\nconst wrapper = mount();\nexpect(wrapper.find(Foo).last().props().foo).to.equal('bar');\n```\n\n\n#### Related Methods\n\n- [`.at(index) => ReactWrapper`](at.md) - retrieve a wrapper node by index\n- [`.first() => ReactWrapper`](first.md)\n" }, { "path": "docs/api/ReactWrapper/length.md", "content": "# `.length => number`\n\nReturns the number of React nodes enclosed in this wrapper.\n\n\n\n#### Returns\n\n`Number`: count of nodes in the list in this wrapper.\n\n\n\n#### Example\n\n\n```jsx\nconst wrapper = mount(
);\nexpect(wrapper.length).to.equal(1);\n```\n" }, { "path": "docs/api/ReactWrapper/map.md", "content": "# `.map(fn) => Array`\n\nMaps the current array of nodes to another array. Each node is passed in as a `ReactWrapper`\nto the map function.\n\n\n#### Arguments\n\n1. `fn` (`Function ( ReactWrapper node, Number index ) => Any`): A mapping function to be run for every node in\nthe collection, the results of which will be mapped to the returned array. Should expect a ReactWrapper as the first argument, and will be run with a context of\nthe original instance.\n\n\n\n#### Returns\n\n`Array`: Returns an array of the returned values from the mapping function..\n\n\n\n#### Example\n\n```jsx\nconst wrapper = mount((\n
\n
bax
\n
bar
\n
baz
\n
\n));\n\nconst texts = wrapper.find('.foo').map((node) => node.text());\nexpect(texts).to.eql(['bax', 'bar', 'baz']);\n```\n\n\n#### Related Methods\n\n- [`.forEach(fn) => ReactWrapper`](forEach.md)\n- [`.reduce(fn[, initialValue]) => Any`](reduce.md)\n- [`.reduceRight(fn[, initialValue]) => Any`](reduceRight.md)\n" }, { "path": "docs/api/ReactWrapper/matchesElement.md", "content": "# `.matchesElement(patternNode) => Boolean`\n\nReturns whether or not a given react element `patternNode` matches the wrapper's render tree. It must be a single-node wrapper, and only the root node is checked.\n\nThe `patternNode` acts like a wildcard. For it to match a node in the wrapper:\n* tag names must match\n* contents must match: In text nodes, leading and trailing spaces are ignored, but not space in the middle. Child elements must match according to these rules, recursively.\n* `patternNode` props (attributes) must appear in the wrapper's nodes, but not the other way around. Their values must match if they do appear.\n* `patternNode` style CSS properties must appear in the wrapper's node's style, but not the other way around. Their values must match if they do appear.\n\n\n#### Arguments\n\n1. `patternNode` (`ReactElement`): The node whose presence you are detecting in the wrapper's single node.\n\n\n#### Returns\n\n`Boolean`: whether or not the current wrapper match the one passed in.\n\n\n#### Example\n\n\n```jsx\nclass MyComponent extends React.Component {\n constructor(props) {\n super(props);\n this.handleClick = this.handleClick.bind(this);\n }\n\n handleClick() {\n // ...\n }\n\n render() {\n return (\n \n );\n }\n}\n\nconst wrapper = mount().childAt(0);\nexpect(wrapper.matchesElement()).to.equal(true);\nexpect(wrapper.matchesElement()).to.equal(true);\n```\n\n\n#### Common Gotchas\n\n- `.matchesElement()` expects a ReactElement, not a selector (like many other methods). Make sure that\nwhen you are calling it you are calling it with a ReactElement or a JSX expression.\n- Keep in mind that this method determines matching based on the matching of the node's children as\nwell.\n\n\n#### Related Methods\n\n- [`.containsMatchingElement() => ReactWrapper`](containsMatchingElement.md) - searches all nodes in the wrapper, and searches their entire depth\n" }, { "path": "docs/api/ReactWrapper/mount.md", "content": "# `.mount() => Self`\n\nA method that re-mounts the component, if it is not currently mounted. This can be used to simulate a component going through\nan unmount/mount lifecycle.\n\nNo equivalent for ShallowWrappers.\n\n#### Returns\n\n`ReactWrapper`: Returns itself.\n\n\n#### Example\n\n```jsx\nimport PropTypes from 'prop-types';\nimport sinon from 'sinon';\n\nconst willMount = sinon.spy();\nconst didMount = sinon.spy();\nconst willUnmount = sinon.spy();\n\nclass Foo extends React.Component {\n constructor(props) {\n super(props);\n this.componentWillUnmount = willUnmount;\n this.componentWillMount = willMount;\n this.componentDidMount = didMount;\n }\n\n render() {\n const { id } = this.props;\n return (\n
\n {id}\n
\n );\n }\n}\nFoo.propTypes = {\n id: PropTypes.string.isRequired,\n};\n\nconst wrapper = mount();\nexpect(willMount).to.have.property('callCount', 1);\nexpect(didMount).to.have.property('callCount', 1);\nexpect(willUnmount).to.have.property('callCount', 0);\nwrapper.unmount();\nexpect(willMount).to.have.property('callCount', 1);\nexpect(didMount).to.have.property('callCount', 1);\nexpect(willUnmount).to.have.property('callCount', 1);\nwrapper.mount();\nexpect(willMount).to.have.property('callCount', 2);\nexpect(didMount).to.have.property('callCount', 2);\nexpect(willUnmount).to.have.property('callCount', 1);\n```\n\n\n#### Related Methods\n\n- [`.unmount() => Self`](unmount.md)\n" }, { "path": "docs/api/ReactWrapper/name.md", "content": "# `.name() => String|null`\n\nReturns the name of the current node of this wrapper. If it's a composite component, this will be\nthe name of the component. If it's a native DOM node, it will be a string of the tag name. If it's\n`null`, it will be `null`.\n\nThe order of precedence on returning the name is: `type.displayName` -> `type.name` -> `type`.\n\nNote: can only be called on a wrapper of a single node.\n\n\n#### Returns\n\n`String|null`: The name of the current node\n\n\n\n#### Examples\n\n```jsx\nconst wrapper = mount(
);\nexpect(wrapper.name()).to.equal('div');\n```\n\n```jsx\nconst wrapper = mount();\nexpect(wrapper.name()).to.equal('Foo');\n```\n\n```jsx\nFoo.displayName = 'A cool custom name';\nconst wrapper = mount();\nexpect(wrapper.name()).to.equal('A cool custom name');\n```\n" }, { "path": "docs/api/ReactWrapper/not.md", "content": "# `.not(selector) => ReactWrapper`\n\nReturns a new wrapper with only the nodes of the current wrapper that don't match the provided\nselector.\n\nThis method is effectively the negation or inverse of [`filter`](filter.md).\n\n\n#### Arguments\n\n1. `selector` ([`EnzymeSelector`](../selector.md)): The selector to match.\n\n\n\n#### Returns\n\n`ReactWrapper`: A new wrapper that wraps the filtered nodes.\n\n\n\n#### Examples\n\n```jsx\nconst wrapper = mount();\nexpect(wrapper.find('.foo').not('.bar')).to.have.lengthOf(1);\n```\n\n#### Related Methods\n\n- [`.filterWhere(predicate) => ReactWrapper`](filterWhere.md)\n- [`.filter(selector) => ReactWrapper`](filter.md)\n" }, { "path": "docs/api/ReactWrapper/parent.md", "content": "# `.parent() => ReactWrapper`\n\nReturns a wrapper with the direct parent of the node in the current wrapper.\n\n\n#### Returns\n\n`ReactWrapper`: A new wrapper that wraps the resulting nodes.\n\n\n#### Examples\n\n```jsx\nconst wrapper = mount();\nexpect(wrapper.find('ul').parent().is('div')).to.equal(true);\n```\n\n#### Related Methods\n\n- [`.parents([selector]) => ReactWrapper`](parents.md)\n- [`.children([selector]) => ReactWrapper`](children.md)\n- [`.closest(selector) => ReactWrapper`](closest.md)\n" }, { "path": "docs/api/ReactWrapper/parents.md", "content": "# `.parents([selector]) => ReactWrapper`\n\nReturns a wrapper around all of the parents/ancestors of the single node in the wrapper. Does not include the node itself.\nOptionally, a selector can be provided and it will filter the parents by this selector. It must be a single-node wrapper.\n\n\n#### Arguments\n\n1. `selector` ([`EnzymeSelector`](../selector.md) [optional]): The selector to filter the parents by.\n\n\n#### Returns\n\n`ReactWrapper`: A new wrapper that wraps the resulting nodes.\n\n\n#### Examples\n\n```jsx\nconst wrapper = mount();\nexpect(wrapper.find('ul').parents()).to.have.lengthOf(2);\n```\n\n#### Related Methods\n\n- [`.children([selector]) => ReactWrapper`](children.md)\n- [`.parent() => ReactWrapper`](parent.md)\n- [`.closest(selector) => ReactWrapper`](closest.md)\n" }, { "path": "docs/api/ReactWrapper/prop.md", "content": "# `.prop(key) => Any`\n\nReturns the prop value for the root node of the wrapper with the provided key. It must be a single-node wrapper.\n\n#### Arguments\n\n1. `key` (`String`): The prop name, that is, `this.props[key]` or `props[key]` for the root node of the wrapper.\n\n\n#### Example\n\n\n```jsx\nconst wrapper = mount();\nexpect(wrapper.prop('foo')).to.equal(10);\n```\n\n\n#### Related Methods\n\n- [`.props() => Object`](props.md)\n- [`.state([key]) => Any`](state.md)\n- [`.context([key]) => Any`](context.md)\n" }, { "path": "docs/api/ReactWrapper/props.md", "content": "# `.props() => Object`\n\nReturns the props object for the root node of the wrapper. It must be a single-node wrapper.\n\nThis method is a reliable way of accessing the props of a node; `wrapper.instance().props` will work as well, but in React 16+, stateless functional components do not have an instance. See [`.instance() => ReactComponent`](instance.md)\n\n\n#### Example\n```jsx\nimport PropTypes from 'prop-types';\n\nfunction MyComponent(props) {\n const { includedProp } = props;\n return (\n
Hello
\n );\n}\nMyComponent.propTypes = {\n includedProp: PropTypes.string.isRequired,\n};\n\nconst wrapper = mount();\nexpect(wrapper.props().includedProp).to.equal('Success!');\n\n// Warning: .props() only returns props that are passed to the root node,\n// which does not include excludedProp in this example.\n// See the note above about wrapper.instance().props.\n\nconsole.log(wrapper.props());\n// {children: \"Hello\", className: \"foo bar\", includedProp=\"Success!\"}\n\nconsole.log(wrapper.instance().props); // React 15.x - working as expected\n// {children: \"Hello\", className: \"foo bar\", includedProp:\"Success!\", excludedProp: \"I'm not included\"}\n\nconsole.log(wrapper.instance().props);\n// React 16.* - Uncaught TypeError: Cannot read property 'props' of null\n```\n\n#### Related Methods\n\n- [`.prop(key) => Any`](prop.md)\n- [`.state([key]) => Any`](state.md)\n- [`.context([key]) => Any`](context.md)\n" }, { "path": "docs/api/ReactWrapper/reduce.md", "content": "# `.reduce(fn[, initialValue]) => Any`\n\nApplies the provided reducing function to every node in the wrapper to reduce to a single value.\nEach node is passed in as a `ReactWrapper`, and is processed from left to right.\n\n\n#### Arguments\n\n1. `fn` (`Function`): A reducing function to be run for every node in the collection, with the\nfollowing arguments:\n - `value` (`T`): The value returned by the previous invocation of this function\n - `node` (`ReactWrapper`): A wrapper around the node being processed\n - `index` (`Number`): The index of the node being processed\n\n2. `initialValue` (`T` [optional]): If provided, this will be passed in as the first argument to the first invocation of the reducing function. If omitted, the first `node` will be provided and the iteration will begin on the second node in the collection.\n\n\n#### Returns\n\n`T`: Returns an array of the returned values from the mapping function...\n\n\n#### Example\n\n```jsx\nfunction Foo() {\n return (\n
\n \n \n \n
\n );\n}\n```\n\n```jsx\nconst wrapper = mount();\nconst total = wrapper.find(Bar).reduce((amount, n) => amount + n.prop('amount'), 0);\nexpect(total).to.equal(14);\n```\n\n\n#### Related Methods\n\n- [`.reduceRight(fn[, initialValue]) => Any`](reduceRight.md)\n- [`.forEach(fn) => ReactWrapper`](forEach.md)\n- [`.map(fn) => Array`](map.md)\n" }, { "path": "docs/api/ReactWrapper/reduceRight.md", "content": "# `.reduceRight(fn[, initialValue]) => Any`\n\nApplies the provided reducing function to every node in the wrapper to reduce to a single value.\nEach node is passed in as a `ReactWrapper`, and is processed from right to left.\n\n\n#### Arguments\n\n1. `fn` (`Function`): A reducing function to be run for every node in the collection, with the\nfollowing arguments:\n - `value` (`T`): The value returned by the previous invocation of this function\n - `node` (`ReactWrapper`): A single-node wrapper around the node being processed\n - `index` (`Number`): The index of the node being processed\n\n2. `initialValue` (`T` [optional]): If provided, this will be passed in as the first argument to the first invocation of the reducing function. If omitted, the first `node` will be provided and the iteration will begin on the second node in the collection.\n\n\n#### Returns\n\n`T`: Returns an array of the returned values from the mapping function...\n\n\n#### Example\n\n```jsx\nfunction Foo() {\n return (\n
\n \n \n \n
\n );\n}\n```\n\n```jsx\nconst wrapper = mount();\nconst total = wrapper.find(Bar).reduceRight((amount, n) => amount + n.prop('amount'), 0);\nexpect(total).to.equal(14);\n```\n\n\n#### Related Methods\n\n- [`.reduce(fn[, initialValue]) => Any`](reduce.md)\n- [`.forEach(fn) => ReactWrapper`](forEach.md)\n- [`.map(fn) => Array`](map.md)\n" }, { "path": "docs/api/ReactWrapper/ref.md", "content": "# `.ref(refName) => ReactComponent | HTMLElement`\n\nReturns the node that matches the provided reference name.\n\n\nNOTE: can only be called on a wrapper instance that is also the root instance.\n\n#### Arguments\n\n1. `refName` (`String`): The ref attribute of the node\n\n\n#### Returns\n\n`ReactComponent | HTMLElement`: The node that matches the provided reference name. This can be a react component instance, or an HTML element instance.\n\n\n#### Examples\n\n\n```jsx\nclass Foo extends React.Component {\n render() {\n return (\n
\n First\n Second\n Third\n
\n );\n }\n}\n```\n\n```jsx\nconst wrapper = mount();\nexpect(wrapper.ref('secondRef').innerText).to.equal('Second');\n```\n\n\n#### Related Methods\n\n- [`.find(selector) => ReactWrapper`](find.md)\n- [`.findWhere(predicate) => ReactWrapper`](findWhere.md)\n" }, { "path": "docs/api/ReactWrapper/render.md", "content": "# `.render() => CheerioWrapper`\n\nReturns a CheerioWrapper around the rendered HTML of the single node's subtree.\nIt must be a single-node wrapper.\n\n\n#### Returns\n\n`CheerioWrapper`: The resulting Cheerio object\n\n\n#### Examples\n\n```jsx\nfunction Foo() {\n return (
);\n}\n```\n\n```jsx\nfunction Bar() {\n return (\n
\n \n
\n );\n}\n```\n\n```jsx\nconst wrapper = mount();\nexpect(wrapper.find('.in-foo')).to.have.lengthOf(1);\nexpect(wrapper.render().find('.in-foo')).to.have.lengthOf(1);\n```\n" }, { "path": "docs/api/ReactWrapper/renderProp.md", "content": "# `.renderProp(propName)(...args) => ReactWrapper`\n\nReturns a function that, when called with arguments `args`, will return a new wrapper based on the render prop in the original wrapper's prop `propName`.\n\nNOTE: can only be called on wrapper of a single non-DOM component element node.\n\n#### Arguments\n\n1. `propName` (`String`):\n1. `...args` (`Array`):\n\nThis essentially calls `wrapper.prop(propName)(...args)`.\n\n#### Returns\n\n`ReactWrapper`: A new wrapper that wraps the node returned from the render prop.\n\n#### Examples\n\n##### Test Setup\n\n```jsx\nclass Mouse extends React.Component {\n constructor() {\n super();\n this.state = { x: 0, y: 0 };\n }\n\n render() {\n const { render } = this.props;\n return (\n {\n this.setState({\n x: event.clientX,\n y: event.clientY,\n });\n }}\n >\n {render(this.state)}\n
\n );\n }\n}\n\nMouse.propTypes = {\n render: PropTypes.func.isRequired,\n};\n```\n\n```jsx\nfunction App() {\n return (\n
\n (\n

\n The mouse position is ({x}, {y})\n

\n )}\n />\n
\n );\n}\n```\n\n##### Testing with no arguments\n\n```jsx\nconst wrapper = mount()\n .find(Mouse)\n .renderProp('render')();\n\nexpect(wrapper.equals(

The mouse position is 0, 0

)).to.equal(true);\n```\n\n##### Testing with multiple arguments\n\n```jsx\nconst wrapper = mount()\n .find(Mouse)\n .renderProp('render')(10, 20);\n\nexpect(wrapper.equals(

The mouse position is 10, 20

)).to.equal(true);\n```\n" }, { "path": "docs/api/ReactWrapper/setContext.md", "content": "# `.setContext(context) => Self`\n\nA method that sets the context of the root component, and re-renders. Useful for when you are\nwanting to test how the component behaves over time with changing contexts.\n\nNOTE: can only be called on a wrapper instance that is also the root instance.\n\n\n#### Arguments\n\n1. `context` (`Object`): An object containing new props to merge in with the current state\n\n\n\n#### Returns\n\n`ReactWrapper`: Returns itself.\n\n\n\n#### Example\n\n```jsx\nimport React from 'react';\nimport PropTypes from 'prop-types';\n\nfunction SimpleComponent(props, context) {\n const { name } = context;\n return
{name}
;\n}\nSimpleComponent.contextTypes = {\n name: PropTypes.string,\n};\n```\n```jsx\nconst context = { name: 'foo' };\nconst wrapper = mount(, { context });\nexpect(wrapper.text()).to.equal('foo');\nwrapper.setContext({ name: 'bar' });\nexpect(wrapper.text()).to.equal('bar');\nwrapper.setContext({ name: 'baz' });\nexpect(wrapper.text()).to.equal('baz');\n```\n\n#### Common Gotchas\n\n- `.setContext()` can only be used on a wrapper that was initially created with a call to `mount()`\nthat includes a `context` specified in the options argument.\n- The root component you are rendering must have a `contextTypes` static property.\n\n\n#### Related Methods\n\n- [`.setState(state[, callback]) => Self`](setState.md)\n- [`.setProps(props[, callback]) => Self`](setProps.md)\n\n\n" }, { "path": "docs/api/ReactWrapper/setProps.md", "content": "# `.setProps(nextProps[, callback]) => Self`\n\nA method that sets the props of the root component, and re-renders. Useful for when you are\nwanting to test how the component behaves over time with changing props. Calling this, for\ninstance, will call the `componentWillReceiveProps` lifecycle method.\n\nSimilar to `setState`, this method accepts a props object and will merge it in with the already\nexisting props.\n\nNOTE: can only be called on a wrapper instance that is also the root instance.\n\n\n#### Arguments\n\n1. `nextProps` (`Object`): An object containing new props to merge in with the current props\n2. `callback` (`Function` [optional]): If provided, the callback function will be executed once setProps has completed\n\n\n#### Returns\n\n`ReactWrapper`: Returns itself.\n\n\n#### Example\n\n```jsx\nimport React from 'react';\nimport PropTypes from 'prop-types';\n\nfunction Foo({ name }) {\n return (\n
\n );\n}\nFoo.propTypes = {\n name: PropTypes.string.isRequired,\n};\n```\n```jsx\nconst wrapper = mount();\nexpect(wrapper.find('.foo')).to.have.lengthOf(1);\nexpect(wrapper.find('.bar')).to.have.lengthOf(0);\nwrapper.setProps({ name: 'bar' });\nexpect(wrapper.find('.foo')).to.have.lengthOf(0);\nexpect(wrapper.find('.bar')).to.have.lengthOf(1);\n```\n\n```jsx\nimport sinon from 'sinon';\n\nconst spy = sinon.spy(MyComponent.prototype, 'componentWillReceiveProps');\n\nconst wrapper = mount();\nexpect(spy).to.have.property('callCount', 0);\nwrapper.setProps({ foo: 'foo' });\nexpect(spy).to.have.property('callCount', 1);\n```\n\n\n#### Related Methods\n\n- [`.setState(state) => Self`](setState.md)\n- [`.setContext(context) => Self`](setContext.md)\n" }, { "path": "docs/api/ReactWrapper/setState.md", "content": "# `.setState(nextState[, callback]) => Self`\n\nA method to invoke `setState()` on the root component instance, similar to how you might in the\nmethods of the component, and re-renders. This method is useful for testing your component\nin hard-to-achieve states, however should be used sparingly. If possible, you should utilize\nyour component's external API (which is often accessible via [`.instance()`](instance.md)) in order\nto get it into whatever state you want to test, in order to be as accurate of a test as possible.\nThis is not always practical, however.\n\nNOTE: Prior to v3.8.0 of enzyme, can only be called on a wrapper instance that is also the root instance.\n\n#### Arguments\n\n1. `nextState` (`Object`): An object containing new state to merge in with the current state\n2. `callback` (`Function` [optional]): If provided, the callback function will be executed once setState has completed\n\n\n#### Returns\n\n`ReactWrapper`: Returns itself.\n\n\n#### Example\n\n```jsx\nclass Foo extends React.Component {\n constructor(props) {\n super(props);\n this.state = { name: 'foo' };\n }\n\n render() {\n const { name } = this.state;\n return (\n
\n );\n }\n}\n```\n```jsx\nconst wrapper = mount();\nexpect(wrapper.find('.foo')).to.have.lengthOf(1);\nexpect(wrapper.find('.bar')).to.have.lengthOf(0);\nwrapper.setState({ name: 'bar' });\nexpect(wrapper.find('.foo')).to.have.lengthOf(0);\nexpect(wrapper.find('.bar')).to.have.lengthOf(1);\n```\n\n\n#### Related Methods\n\n- [`.setProps(props[, callback]) => Self`](setProps.md)\n- [`.setContext(context) => Self`](setContext.md)\n" }, { "path": "docs/api/ReactWrapper/simulate.md", "content": "# `.simulate(event[, mock]) => Self`\n\nSimulate events on the root node in the wrapper. It must be a single-node wrapper.\n\n\n#### Arguments\n\n1. `event` (`String`): The event name to be simulated\n2. `mock` (`Object` [optional]): A mock event object that will be merged with the event object passed to the handlers.\n\n\n#### Returns\n\n`ReactWrapper`: Returns itself.\n\n\n#### Example `class component`\n\n```jsx\nclass Foo extends React.Component {\n constructor(props) {\n super(props);\n this.state = { count: 0 };\n }\n\n render() {\n const { count } = this.state;\n return (\n \n );\n }\n}\n\nconst wrapper = mount();\n\nexpect(wrapper.find('.clicks-0').length).to.equal(1);\nwrapper.find('a').simulate('click');\nexpect(wrapper.find('.clicks-1').length).to.equal(1);\n```\n\n#### Example `functional component`\n\n```jsx\nfunction Foo({ width, height, onChange }) {\n return (\n
\n \n \n
\n );\n}\nFoo.propTypes = {\n width: PropTypes.number.isRequired,\n height: PropTypes.number.isRequired,\n onChange: PropTypes.func.isRequired,\n};\n\nconst testState = { width: 10, height: 20 };\nconst wrapper = mount((\n {\n testState[e.target.name] = e.target.value;\n }}\n />\n));\n\nexpect(wrapper.find('input').at(0).props().value).to.equal(10);\nexpect(wrapper.find('input').at(1).props().value).to.equal(20);\nwrapper.find('input').at(0).simulate('change', { target: { name: 'width', value: 50 } });\nwrapper.find('input').at(1).simulate('change', { target: { name: 'height', value: 70 } });\nexpect(testState.width).to.equal(50);\nexpect(testState.height).to.equal(70);\n```\n\n#### Common Gotchas\n\n- As noted in the function signature above passing a mock event is optional. It is worth noting that `ReactWrapper` will pass a `SyntheticEvent` object to the event handler in your code. Keep in mind that if the code you are testing uses properties that are not included in the `SyntheticEvent`, for instance `event.target.value`, you will need to provide a mock event like so `.simulate(\"change\", { target: { value: \"foo\" }})` for it to work.\n\n" }, { "path": "docs/api/ReactWrapper/simulateError.md", "content": "# `.simulateError(error) => Self`\n\nSimulate a component throwing an error as part of its rendering lifecycle.\n\nThis is particularly useful in combination with React 16 error boundaries (ie, the `componentDidCatch` and `static getDerivedStateFromError` lifecycle methods).\n\n\n#### Arguments\n\n1. `error` (`Any`): The error to throw.\n\n\n\n#### Returns\n\n`ReactWrapper`: Returns itself.\n\n\n\n#### Example\n\n```jsx\nfunction Something() {\n // this is just a placeholder\n return null;\n}\n\nclass ErrorBoundary extends React.Component {\n static getDerivedStateFromError(error) {\n return {\n hasError: true,\n };\n }\n\n constructor(props) {\n super(props);\n this.state = { hasError: false };\n }\n\n componentDidCatch(error, info) {\n const { spy } = this.props;\n spy(error, info);\n }\n\n render() {\n const { children } = this.props;\n const { hasError } = this.state;\n return (\n \n {hasError ? 'Error' : children}\n \n );\n }\n}\nErrorBoundary.propTypes = {\n children: PropTypes.node.isRequired,\n spy: PropTypes.func.isRequired,\n};\n\nconst spy = sinon.spy();\nconst wrapper = mount();\nconst error = new Error('hi!');\nwrapper.find(Something).simulateError(error);\n\nexpect(wrapper.state()).to.have.property('hasError', true);\nexpect(spy).to.have.property('callCount', 1);\nexpect(spy.args).to.deep.equal([\n error,\n {\n componentStack: `\n in Something (created by ErrorBoundary)\n in ErrorBoundary (created by WrapperComponent)\n in WrapperComponent`,\n },\n]);\n```\n" }, { "path": "docs/api/ReactWrapper/slice.md", "content": "# `.slice([begin[, end]]) => ReactWrapper`\n\nReturns a new wrapper with a subset of the nodes of the original wrapper, according to the rules of `Array#slice`.\n\n\n#### Arguments\n\n1. `begin` (`Number` [optional]): Index from which to slice (defaults to `0`). If negative, this is treated as `length+begin`.\n1. `end` (`Number` [optional]): Index at which to end slicing (defaults to `length`). If negative, this is treated as `length+end`.\n\n\n\n#### Returns\n\n`ReactWrapper`: A new wrapper with the subset of nodes specified.\n\n\n\n#### Examples\n\n```jsx\nconst wrapper = mount((\n
\n
\n
\n
\n
\n));\nexpect(wrapper.find('.foo').slice(1)).to.have.lengthOf(2);\nexpect(wrapper.find('.foo').slice(1).at(0).hasClass('bar')).to.equal(true);\nexpect(wrapper.find('.foo').slice(1).at(1).hasClass('baz')).to.equal(true);\n```\n\n```jsx\nconst wrapper = mount((\n
\n
\n
\n
\n
\n));\nexpect(wrapper.find('.foo').slice(1, 2)).to.have.lengthOf(1);\nexpect(wrapper.find('.foo').slice(1, 2).at(0).hasClass('bar')).to.equal(true);\n```\n" }, { "path": "docs/api/ReactWrapper/some.md", "content": "# `.some(selector) => Boolean`\n\nReturns whether or not any of the nodes in the wrapper match the provided selector.\n\n\n#### Arguments\n\n1. `selector` ([`EnzymeSelector`](../selector.md)): The selector to match.\n\n\n\n#### Returns\n\n`Boolean`: True if at least one of the nodes in the current wrapper matched the provided selector.\n\n\n\n#### Examples\n\n```jsx\nconst wrapper = mount((\n
\n
\n
\n
\n
\n));\nexpect(wrapper.find('.foo').some('.qoo')).to.equal(true);\nexpect(wrapper.find('.foo').some('.foo')).to.equal(true);\nexpect(wrapper.find('.foo').some('.bar')).to.equal(false);\n```\n\n#### Related Methods\n\n- [`.someWhere(predicate) => Boolean`](someWhere.md)\n- [`.every(selector) => Boolean`](every.md)\n- [`.everyWhere(predicate) => Boolean`](everyWhere.md)\n" }, { "path": "docs/api/ReactWrapper/someWhere.md", "content": "# `.someWhere(fn) => Boolean`\n\nReturns whether or not any of the nodes in the wrapper pass the provided predicate function.\n\n\n#### Arguments\n\n1. `predicate` (`ReactWrapper => Boolean`): A predicate function to match the nodes.\n\n\n\n#### Returns\n\n`Boolean`: True if at least one of the nodes in the current wrapper passed the predicate function.\n\n\n\n#### Example\n\n```jsx\nconst wrapper = mount((\n
\n
\n
\n
\n
\n));\nexpect(wrapper.find('.foo').someWhere((n) => n.hasClass('qoo'))).to.equal(true);\nexpect(wrapper.find('.foo').someWhere((n) => n.hasClass('foo'))).to.equal(true);\nexpect(wrapper.find('.foo').someWhere((n) => n.hasClass('bar'))).to.equal(false);\n```\n\n\n#### Related Methods\n\n- [`.some(selector) => Boolean`](some.md)\n- [`.every(selector) => Boolean`](every.md)\n- [`.everyWhere(predicate) => Boolean`](everyWhere.md)\n" }, { "path": "docs/api/ReactWrapper/state.md", "content": "# `.state([key]) => Any`\n\nReturns the state hash for the root node of the wrapper. Optionally pass in a prop name and it\nwill return just that value.\n\n\n#### Arguments\n\n1. `key` (`String` [optional]): If provided, the return value will be the `this.state[key]` of the\nroot component instance.\n\n\n\n#### Example\n\n\n```jsx\nconst wrapper = mount();\nexpect(wrapper.state().foo).to.equal(10);\nexpect(wrapper.state('foo')).to.equal(10);\n```\n\n\n#### Related Methods\n\n- [`.props() => Object`](props.md)\n- [`.prop(key) => Any`](prop.md)\n- [`.context([key]) => Any`](context.md)\n" }, { "path": "docs/api/ReactWrapper/tap.md", "content": "# `.tap(intercepter) => Self`\n\nInvokes intercepter and returns itself. intercepter is called with itself.\nThis is helpful when debugging nodes in method chains.\n\n#### Arguments\n\n1. `intercepter` (`Self`): the current ReactWrapper instance.\n\n\n\n#### Returns\n\n`Self`: the current ReactWrapper instance.\n\n\n\n#### Example\n\n\n```jsx\nconst result = mount((\n
    \n
  • xxx
    • \n
  • yyy
    • \n
  • zzz
    • \n
\n)).find('li')\n .tap((n) => console.log(n.debug()))\n .map((n) => n.text());\n```\n" }, { "path": "docs/api/ReactWrapper/text.md", "content": "# `.text() => String`\n\nReturns a string of the rendered text of the current render tree. This function should be\nlooked at with skepticism if being used to test what the actual HTML output of the component\nwill be. If that is what you would like to test, use enzyme's `render` function instead.\n\nNote: can only be called on a wrapper of a single node.\n\n\n#### Returns\n\n`String`: The resulting string\n\n\n#### Examples\n\n```jsx\nconst wrapper = mount(
important
);\nexpect(wrapper.text()).to.equal('important');\n```\n\n```jsx\nfunction Foo() {\n return
This is
;\n}\n\nconst wrapper = mount(
really important
);\nexpect(wrapper.text()).to.equal('This is really important');\n```\n\n\n#### Related Methods\n\n[`.html() => String`](html.md)\n" }, { "path": "docs/api/ReactWrapper/type.md", "content": "# `.type() => String | Function | null`\n\nReturns the type of the only node of this wrapper.\nIf it's a React component, this will be the component constructor.\nIf it's a native DOM node, it will be a string with the tag name.\nIf it's `null`, it will be `null`. It must be a single-node wrapper.\n\n\n#### Returns\n\n`String | Function | null`: The type of the node\n\n\n#### Examples\n\n```jsx\nfunction Foo() {\n return
;\n}\nconst wrapper = mount().childAt(0);\nexpect(wrapper.type()).to.equal('div');\n```\n\n```jsx\nfunction Foo() {\n return (\n
\n \n
\n );\n}\nconst wrapper = mount();\nexpect(wrapper.find('.btn').type()).to.equal('button');\n```\n\n```jsx\nfunction Foo() {\n return ;\n}\nconst wrapper = mount();\nexpect(wrapper.type()).to.equal(Foo);\nexpect(wrapper.childAt(0).type()).to.equal(Bar);\n```\n\n```jsx\nfunction Null() {\n return null;\n}\nconst wrapper = mount();\nexpect(wrapper.type()).to.equal(null);\n```\n" }, { "path": "docs/api/ReactWrapper/unmount.md", "content": "# `.unmount() => Self`\n\nA method that unmounts the component. This can be used to simulate a component going through\nan unmount/mount lifecycle.\n\n#### Returns\n\n`ReactWrapper`: Returns itself.\n\n\n\n#### Example\n\n```jsx\nimport PropTypes from 'prop-types';\nimport sinon from 'sinon';\n\nconst willMount = sinon.spy();\nconst didMount = sinon.spy();\nconst willUnmount = sinon.spy();\n\nclass Foo extends React.Component {\n constructor(props) {\n super(props);\n this.componentWillUnmount = willUnmount;\n this.componentWillMount = willMount;\n this.componentDidMount = didMount;\n }\n\n render() {\n const { id } = this.props;\n return (\n
\n {id}\n
\n );\n }\n}\nFoo.propTypes = {\n id: PropTypes.string.isRequired,\n};\nconst wrapper = mount();\nexpect(willMount).to.have.property('callCount', 1);\nexpect(didMount).to.have.property('callCount', 1);\nexpect(willUnmount).to.have.property('callCount', 0);\nwrapper.unmount();\nexpect(willMount).to.have.property('callCount', 1);\nexpect(didMount).to.have.property('callCount', 1);\nexpect(willUnmount).to.have.property('callCount', 1);\n```\n\n\n#### Related Methods\n\n- [`.mount() => Self`](mount.md)\n" }, { "path": "docs/api/ReactWrapper/update.md", "content": "# `.update() => Self`\n\nSyncs the enzyme component tree snapshot with the react component tree. Useful to run before checking the render output if something external\nmay be updating the state of the component somewhere.\n\nNOTE: no matter what instance this is called on, it will always update the root.\n\nNOTE: only updates Enzyme's representation of rendered tree.\n\nNOTE: this does not force a re-render. Use `wrapper.setProps({})` to force a re-render.\n\n\n#### Returns\n\n`ReactWrapper`: Returns itself.\n\n\n\n#### Example\n\n```jsx\nclass UpdateEnzyme extends React.Component {\n constructor(props) {\n super(props);\n this.state = {\n count: 0,\n };\n this.increment = this.increment.bind(this);\n }\n\n increment() {\n const { count } = this.state;\n this.setState({ count: count + 1 });\n }\n\n render() {\n const { count } = this.state;\n return ;\n }\n}\n```\n```jsx\nconst wrapper = mount();\nexpect(wrapper.find('button.increment').text()).to.equal('0');\nwrapper.instance().increment();\n\n// Update Enzyme's view of output\nwrapper.update();\n\nexpect(wrapper.find('button.increment').text()).to.equal('1');\n```\n" }, { "path": "docs/api/ShallowWrapper/at.md", "content": "# `.at(index) => ShallowWrapper`\n\nReturns a wrapper around the node at a given index of the current wrapper.\n\n\n#### Arguments\n\n1. `index` (`Number`): A zero-based integer indicating which node to retrieve.\n\n\n\n#### Returns\n\n`ShallowWrapper`: A new wrapper that wraps the retrieved node.\n\n\n\n#### Examples\n\n```jsx\nconst wrapper = shallow();\nexpect(wrapper.find(Foo).at(0).props().foo).to.equal('bar');\n```\n\n\n\n#### Related Methods\n\n- [`.get(index) => ReactElement`](get.md) - same, but returns the React node itself, with no wrapper.\n- [`.first() => ShallowWrapper`](first.md) - same as at(0)\n- [`.last() => ShallowWrapper`](last.md)\n" }, { "path": "docs/api/ShallowWrapper/childAt.md", "content": "# `.childAt(index) => ShallowWrapper`\n\nReturns a new wrapper with child at the specified index.\n\n#### Arguments\n\n1. `index` (`number`): A zero-based integer indicating which node to retrieve.\n\n\n#### Returns\n\n`ShallowWrapper`: A new wrapper that wraps the resulting node.\n\n\n\n#### Examples\n\n```jsx\nconst wrapper = shallow();\nexpect(wrapper.find('ul').childAt(0).type()).to.equal('li');\n```\n\n#### Related Methods\n\n- [`.parents([selector]) => ShallowWrapper`](parents.md)\n- [`.parent() => ShallowWrapper`](parent.md)\n- [`.closest(selector) => ShallowWrapper`](closest.md)\n- [`.children([selector]) => ShallowWrapper`](children.md)\n" }, { "path": "docs/api/ShallowWrapper/children.md", "content": "# `.children([selector]) => ShallowWrapper`\n\nReturns a new wrapper with all of the children of the node(s) in the current wrapper. Optionally, a\nselector can be provided and it will filter the children by this selector\n\n\n#### Arguments\n\n1. `selector` ([`EnzymeSelector`](../selector.md) [optional]): A selector to filter the children by.\n\n\n#### Returns\n\n`ShallowWrapper`: A new wrapper that wraps the resulting nodes.\n\n\n\n#### Examples\n\n```jsx\nconst wrapper = shallow();\nexpect(wrapper.find('ul').children()).to.have.lengthOf(items.length);\n```\n\n#### Related Methods\n\n- [`.parents([selector]) => ShallowWrapper`](parents.md)\n- [`.parent() => ShallowWrapper`](parent.md)\n- [`.closest(selector) => ShallowWrapper`](closest.md)\n" }, { "path": "docs/api/ShallowWrapper/closest.md", "content": "# `.closest(selector) => ShallowWrapper`\n\nReturns a wrapper of the first element that matches the selector by traversing up through the\nwrapped node's ancestors in the tree, starting with itself. It must be a single-node wrapper.\n\n#### Arguments\n\n1. `selector` ([`EnzymeSelector`](../selector.md)): The selector to match.\n\n#### Returns\n\n`ShallowWrapper`: A new wrapper that wraps the resulting node.\n\n\n\n#### Examples\n\n```jsx\nconst wrapper = shallow();\nexpect(wrapper.find(Foo).closest('.bar')).to.have.lengthOf(1);\n```\n\n#### Related Methods\n\n- [`.children([selector]) => ShallowWrapper`](children.md)\n- [`.parent() => ShallowWrapper`](parent.md)\n- [`.parents([selector]) => ShallowWrapper`](parents.md)\n" }, { "path": "docs/api/ShallowWrapper/contains.md", "content": "# `.contains(nodeOrNodes) => Boolean`\n\nReturns whether or not all given react elements match elements in the render tree.\nIt will determine if an element in the wrapper matches the expected element by checking if the expected element has the same props as the wrapper's element and share the same values.\n\n\n#### Arguments\n\n1. `nodeOrNodes` (`ReactElement|Array`): The node or array of nodes whose presence you are detecting in the current instance's\nrender tree.\n\n\n\n#### Returns\n\n`Boolean`: whether or not the current wrapper has nodes anywhere in its render tree that match\nthe ones passed in.\n\n\n\n#### Example\n\n\n```jsx\nconst wrapper = shallow((\n
\n
Hello
\n
\n));\n\nexpect(wrapper.contains(
Hello
)).to.equal(true);\n\nexpect(wrapper.contains(
Hello
)).to.equal(false);\nexpect(wrapper.contains(
Hello
)).to.equal(false);\nexpect(wrapper.contains(
Hello
)).to.equal(false);\nexpect(wrapper.contains(
)).to.equal(false);\n```\n\n```jsx\nconst wrapper = shallow((\n
\n Hello\n
Goodbye
\n Again\n
\n));\n\nexpect(wrapper.contains([\n Hello,\n
Goodbye
,\n])).to.equal(true);\n\nexpect(wrapper.contains([\n Hello,\n
World
,\n])).to.equal(false);\n```\n\n```jsx\nconst calculatedValue = 2 + 2;\n\nconst wrapper = shallow((\n
\n
{calculatedValue}
\n
\n));\n\nexpect(wrapper.contains(
{4}
)).to.equal(true);\n```\n\n#### Common Gotchas\n\n- `.contains()` expects a ReactElement, not a selector (like many other methods). Make sure that\nwhen you are calling it you are calling it with a ReactElement or a JSX expression.\n- Keep in mind that this method determines equality based on the equality of the node's children as\nwell.\n" }, { "path": "docs/api/ShallowWrapper/containsAllMatchingElements.md", "content": "# `.containsAllMatchingElements(patternNodes) => Boolean`\n\nReturns whether or not all of the given react elements in `patternNodes` match an element in the wrapper's render tree. Every single element of `patternNodes` must be matched one or more times. Matching follows the rules for `containsMatchingElement`.\n\n\n#### Arguments\n\n1. `patternNodes` (`Array`): The array of nodes whose presence you are detecting in the current instance's\nrender tree.\n\n\n#### Returns\n\n`Boolean`: whether or not the current wrapper has nodes anywhere in its render tree that looks\nlike the nodes passed in.\n\n\n#### Example\n\n\n```jsx\nconst style = { fontSize: 13 };\nconst wrapper = shallow((\n
\n Hello\n
Goodbye
\n Again\n
\n));\n\nexpect(wrapper.containsAllMatchingElements([\n Hello,\n
Goodbye
,\n])).to.equal(true);\n```\n\n\n#### Common Gotchas\n\n- `.containsAllMatchingElements()` expects an array of ReactElement, not a selector (like many other methods). Make sure that\nwhen you are calling it you are calling it with an array of ReactElement or a JSX expression.\n- Keep in mind that this method determines matching based on the matching of the node's children as\nwell.\n\n\n#### Related Methods\n\n- [`.matchesElement() => ShallowWrapper`](matchesElement.md) - rules for matching each node\n- [`.containsMatchingElement() => ShallowWrapper`](containsMatchingElement.md) - rules for matching whole wrapper\n- [`.containsAnyMatchingElements() => ShallowWrapper`](containsAnyMatchingElements.md) - must match at least one in patternNodes\n" }, { "path": "docs/api/ShallowWrapper/containsAnyMatchingElements.md", "content": "# `.containsAnyMatchingElements(patternNodes) => Boolean`\n\nReturns whether or not at least one of the given react elements in `patternNodes` matches an element in the wrapper's render tree. One or more elements of `patternNodes` must be matched one or more times. Matching follows the rules for `containsMatchingElement`.\n\n\n#### Arguments\n\n1. `patternNodes` (`Array`): The array of nodes whose presence you are detecting in the current instance's\nrender tree.\n\n\n#### Returns\n\n`Boolean`: whether or not the current wrapper has a node anywhere in its render tree that looks\nlike one of the array passed in.\n\n\n#### Example\n\n\n```jsx\nconst style = { fontSize: 13 };\nconst wrapper = shallow((\n
\n Hello\n
Goodbye
\n Again\n
\n));\n\nexpect(wrapper.containsAnyMatchingElements([\n Bonjour,\n
Goodbye
,\n])).to.equal(true);\n```\n\n\n#### Common Gotchas\n\n- `.containsAnyMatchingElements()` expects an array of ReactElement, not a selector (like many other methods). Make sure that\nwhen you are calling it you are calling it with an array ReactElement or a JSX expression.\n- Keep in mind that this method determines equality based on the equality of the node's children as\nwell.\n\n\n#### Related Methods\n\n- [`.matchesElement() => ShallowWrapper`](matchesElement.md) - rules for matching each node\n- [`.containsMatchingElement() => ShallowWrapper`](containsMatchingElement.md) - rules for matching whole wrapper\n- [`.containsAllMatchingElements() => ShallowWrapper`](containsAllMatchingElements.md) - must match all nodes in patternNodes\n" }, { "path": "docs/api/ShallowWrapper/containsMatchingElement.md", "content": "# `.containsMatchingElement(patternNode) => Boolean`\n\nReturns whether or not a `patternNode` react element matches any element in the render tree.\n* the matches can happen anywhere in the wrapper's contents\n* the wrapper can contain more than one node; all are searched\n\nOtherwise, the match follows the same rules as `matchesElement`.\n\n\n#### Arguments\n\n1. `patternNode` (`ReactElement`): The node whose presence you are detecting in the current instance's\nrender tree.\n\n\n#### Returns\n\n`Boolean`: whether or not the current wrapper has a node anywhere in its render tree that matches\nthe one passed in.\n\n\n\n#### Example\n\n\n```jsx\nconst wrapper = shallow((\n
\n
Hello
\n
\n));\n\nexpect(wrapper.containsMatchingElement(
Hello
)).to.equal(true);\nexpect(wrapper.containsMatchingElement(
Hello
)).to.equal(true);\n\nexpect(wrapper.containsMatchingElement(
Hello
)).to.equal(false);\nexpect(wrapper.containsMatchingElement(
Hello
)).to.equal(false);\nexpect(wrapper.containsMatchingElement(
)).to.equal(false);\n```\n\n#### Common Gotchas\n\n- `.containsMatchingElement()` expects a ReactElement, not a selector (like many other methods). Make sure that\nwhen you are calling it you are calling it with a ReactElement or a JSX expression.\n- Keep in mind that this method determines equality based on the equality of the node's children as\nwell.\n\n\n#### Related Methods\n\n- [`.containsAllMatchingElements() => ShallowWrapper`](containsAllMatchingElements.md) - must match all nodes in patternNodes\n- [`.containsAnyMatchingElements() => ShallowWrapper`](containsAnyMatchingElements.md) - must match at least one in patternNodes\n" }, { "path": "docs/api/ShallowWrapper/context.md", "content": "# `.context([key]) => Any`\n\nReturns the context hash for the root node of the wrapper. Optionally pass in a prop name and it\nwill return just that value.\n\n\n#### Arguments\n\n1. `key` (`String` [optional]): If provided, the return value will be the `this.context[key]` of the\nroot component instance.\n\n\n\n#### Example\n\n\n```jsx\nconst wrapper = shallow(\n ,\n { context: { foo: 10 } },\n);\nexpect(wrapper.context().foo).to.equal(10);\nexpect(wrapper.context('foo')).to.equal(10);\n```\n\n\n#### Related Methods\n\n- [`.props() => Object`](props.md)\n- [`.prop(key) => Any`](prop.md)\n- [`.state([key]) => Any`](state.md)\n" }, { "path": "docs/api/ShallowWrapper/debug.md", "content": "# `.debug([options]) => String`\n\nReturns an HTML-like string of the wrapper for debugging purposes. Useful to print out to the\nconsole when tests are not passing when you expect them to.\n\n\n#### Arguments\n\n`options` (`Object` [optional]):\n- `options.ignoreProps`: (`Boolean` [optional]): Whether props should be omitted in the resulting string. Props are included by default.\n- `options.verbose`: (`Boolean` [optional]): Whether arrays and objects passed as props should be verbosely printed.\n\n#### Returns\n\n`String`: The resulting string.\n\n\n\n#### Examples\n```jsx\nfunction Book({ title, pages }) {\n return (\n
\n

{title}

\n {pages && (\n \n )}\n
\n );\n}\nBook.propTypes = {\n title: PropTypes.string.isRequired,\n pages: PropTypes.number,\n};\nBook.defaultProps = {\n pages: null,\n};\n```\n```jsx\nconst wrapper = shallow();\nconsole.log(wrapper.debug());\n```\nOutputs to console:\n```text\n
\n

Huckleberry Finn

\n
\n```\n\n```jsx\nconst wrapper = shallow((\n \n));\nconsole.log(wrapper.debug());\n```\nOutputs to console:\n```text\n
\n

Huckleberry Finn

\n \n
\n```\n\n```jsx\nconst wrapper = shallow((\n \n));\nconsole.log(wrapper.debug({ ignoreProps: true }));\n```\nOutputs to console:\n```text\n
\n

Huckleberry Finn

\n \n
\n```\n\n\n```jsx\nconst wrapper = shallow((\n \n));\nconsole.log(wrapper.debug({ verbose: true }));\n```\nOutputs to console:\n```text\n
\n

Huckleberry Finn

\n \n
\n```\n" }, { "path": "docs/api/ShallowWrapper/dive.md", "content": "# `.dive([options]) => ShallowWrapper`\n\nShallow render the one non-DOM child of the current wrapper, and return a wrapper around the result. It must be a single-node wrapper, and the node must be a React component.\n\nThere is no corresponding `dive` method for ReactWrappers.\n\nNOTE: can only be called on a wrapper of a single non-DOM component element node, otherwise it will throw an error. If you have to shallow-wrap a wrapper with multiple child nodes, use [`.shallow()`](shallow.md).\n\n\n#### Arguments\n\n1. `options` (`Object` [optional]):\n- `options.context`: (`Object` [optional]): Context to be passed into the component\n\n\n#### Returns\n\n`ShallowWrapper`: A new wrapper that wraps the current node after it's been shallow rendered.\n\n\n#### Examples\n\n```jsx\nfunction Bar() {\n return (\n
\n
\n
\n );\n}\n```\n\n```jsx\nfunction Foo() {\n return (\n
\n \n
\n );\n}\n```\n\n```jsx\nconst wrapper = shallow();\nexpect(wrapper.find('.in-bar')).to.have.lengthOf(0);\nexpect(wrapper.find(Bar)).to.have.lengthOf(1);\nexpect(wrapper.find(Bar).dive().find('.in-bar')).to.have.lengthOf(1);\n```\n" }, { "path": "docs/api/ShallowWrapper/equals.md", "content": "# `.equals(node) => Boolean`\n\nReturns whether or not the current wrapper root node render tree looks like the one passed in.\n\n\n#### Arguments\n\n1. `node` (`ReactElement`): The node whose presence you are detecting in the current instance's\nrender tree.\n\n\n\n#### Returns\n\n`Boolean`: whether or not the current wrapper has a node anywhere in it's render tree that looks\nlike the one passed in.\n\n\n\n#### Example\n\n\n```jsx\nfunction MyComponent() {\n return
;\n}\n\nconst wrapper = shallow();\nexpect(wrapper.equals(
)).to.equal(true);\n```\n\n\n#### Common Gotchas\n\n- `.equals()` expects a ReactElement, not a selector (like many other methods). Make sure that\nwhen you are calling it you are calling it with a ReactElement or a JSX expression.\n- Keep in mind that this method determines equality based on the equality of the node's children as\nwell.\n- Following React's behavior, `.equals()` ignores properties whose values are `undefined`.\n" }, { "path": "docs/api/ShallowWrapper/every.md", "content": "# `.every(selector) => Boolean`\n\nReturns whether or not all of the nodes in the wrapper match the provided selector.\n\n\n#### Arguments\n\n1. `selector` ([`EnzymeSelector`](../selector.md)): The selector to match.\n\n\n\n#### Returns\n\n`Boolean`: True if every node in the current wrapper matched the provided selector.\n\n\n\n#### Examples\n\n```jsx\nconst wrapper = shallow((\n
\n
\n
\n
\n
\n));\nexpect(wrapper.find('.foo').every('.foo')).to.equal(true);\nexpect(wrapper.find('.foo').every('.qoo')).to.equal(false);\nexpect(wrapper.find('.foo').every('.bar')).to.equal(false);\n```\n\n#### Related Methods\n\n- [`.someWhere(predicate) => Boolean`](someWhere.md)\n- [`.everyWhere(predicate) => Boolean`](everyWhere.md)\n" }, { "path": "docs/api/ShallowWrapper/everyWhere.md", "content": "# `.everyWhere(fn) => Boolean`\n\nReturns whether or not all of the nodes in the wrapper pass the provided predicate function.\n\n\n#### Arguments\n\n1. `predicate` (`ShallowWrapper => Boolean`): A predicate function to match the nodes.\n\n\n\n#### Returns\n\n`Boolean`: True if every node in the current wrapper passed the predicate function.\n\n\n\n#### Example\n\n```jsx\nconst wrapper = shallow((\n
\n
\n
\n
\n
\n));\nexpect(wrapper.find('.foo').everyWhere((n) => n.hasClass('foo'))).to.equal(true);\nexpect(wrapper.find('.foo').everyWhere((n) => n.hasClass('qoo'))).to.equal(false);\nexpect(wrapper.find('.foo').everyWhere((n) => n.hasClass('bar'))).to.equal(false);\n```\n\n\n#### Related Methods\n\n- [`.some(selector) => Boolean`](some.md)\n- [`.every(selector) => Boolean`](every.md)\n- [`.everyWhere(predicate) => Boolean`](everyWhere.md)\n" }, { "path": "docs/api/ShallowWrapper/exists.md", "content": "# `.exists([selector]) => Boolean`\n\nReturns whether or not any nodes exist in the wrapper. Or, if a selector is passed in, whether that selector has any matches in the wrapper.\n\n\n\n#### Arguments\n\n1. `selector` ([`EnzymeSelector`](../selector.md) [optional]): The selector to check existence for.\n\n\n\n#### Returns\n\n`Boolean`: whether or not any nodes are on the list, or the selector had any matches.\n\n\n\n#### Example\n\n\n```jsx\nconst wrapper = shallow(
);\nexpect(wrapper.exists('.some-class')).to.equal(true);\nexpect(wrapper.find('.other-class').exists()).to.equal(false);\n```\n" }, { "path": "docs/api/ShallowWrapper/filter.md", "content": "# `.filter(selector) => ShallowWrapper`\n\nReturns a new wrapper with only the nodes of the current wrapper that match the provided selector.\n\n\n#### Arguments\n\n1. `selector` ([`EnzymeSelector`](../selector.md)): The selector to match.\n\n\n\n#### Returns\n\n`ShallowWrapper`: A new wrapper that wraps the filtered nodes.\n\n\n\n#### Examples\n\n```jsx\nconst wrapper = shallow();\nexpect(wrapper.find('.foo').filter('.bar')).to.have.lengthOf(1);\n```\n\n#### Related Methods\n\n- [`.filterWhere(predicate) => ShallowWrapper`](filterWhere.md)\n" }, { "path": "docs/api/ShallowWrapper/filterWhere.md", "content": "# `.filterWhere(fn) => ShallowWrapper`\n\nReturns a new wrapper with only the nodes of the current wrapper that, when passed into the\nprovided predicate function, return true.\n\n\n#### Arguments\n\n1. `predicate` (`ShallowWrapper => Boolean`): A predicate function that is passed a wrapped node.\n\n\n\n#### Returns\n\n`ShallowWrapper`: A new wrapper that wraps the filtered nodes.\n\n\n\n#### Example\n\n```jsx\nconst wrapper = shallow();\nconst complexFoo = wrapper.find('.foo').filterWhere((n) => typeof n.type() !== 'string');\nexpect(complexFoo).to.have.lengthOf(4);\n```\n\n\n#### Related Methods\n\n- [`.filter(selector) => ShallowWrapper`](filter.md)\n" }, { "path": "docs/api/ShallowWrapper/find.md", "content": "# `.find(selector) => ShallowWrapper`\n\nFinds every node in the render tree of the current wrapper that matches the provided selector.\n\n\n#### Arguments\n\n1. `selector` ([`EnzymeSelector`](../selector.md)): The selector to match.\n\n\n\n#### Returns\n\n`ShallowWrapper`: A new wrapper that wraps the found nodes.\n\n\n\n#### Examples\n\nCSS Selectors:\n```jsx\nconst wrapper = shallow();\nexpect(wrapper.find('.foo')).to.have.lengthOf(1);\nexpect(wrapper.find('.bar')).to.have.lengthOf(3);\n\n// compound selector\nexpect(wrapper.find('div.some-class')).to.have.lengthOf(3);\n\n// CSS id selector\nexpect(wrapper.find('#foo')).to.have.lengthOf(1);\n```\n\nComponent Constructors:\n```jsx\nimport Foo from '../components/Foo';\n\nconst wrapper = shallow();\nexpect(wrapper.find(Foo)).to.have.lengthOf(1);\n```\n\nComponent Display Name:\n```jsx\nconst wrapper = shallow();\nexpect(wrapper.find('Foo')).to.have.lengthOf(1);\n```\n\nObject Property Selector:\n```jsx\nconst wrapper = shallow();\nexpect(wrapper.find({ prop: 'value' })).to.have.lengthOf(1);\n```\n\n\n#### Related Methods\n\n- [`.findWhere(predicate) => ShallowWrapper`](findWhere.md)\n" }, { "path": "docs/api/ShallowWrapper/findWhere.md", "content": "# `.findWhere(fn) => ShallowWrapper`\n\nFinds every node in the render tree that returns true for the provided predicate function.\n\n\n#### Arguments\n\n1. `predicate` (`ShallowWrapper => Boolean`): A predicate function called with the passed in wrapped\nnodes.\n\n\n\n#### Returns\n\n`ShallowWrapper`: A new wrapper that wraps the found nodes.\n\n\n\n#### Example\n\n```jsx\nconst wrapper = shallow();\nconst complexComponents = wrapper.findWhere((n) => n.type() !== 'string');\nexpect(complexComponents).to.have.lengthOf(8);\n```\n\n\n#### Related Methods\n\n- [`.find(selector) => ShallowWrapper`](find.md)\n" }, { "path": "docs/api/ShallowWrapper/first.md", "content": "# `.first() => ShallowWrapper`\n\nReduce the set of matched nodes to the first in the set, just like `.at(0)`.\n\n\n#### Returns\n\n`ShallowWrapper`: A new wrapper that wraps the first node in the set.\n\n\n#### Examples\n\n```jsx\nconst wrapper = shallow();\nexpect(wrapper.find(Foo).first().props().foo).to.equal('bar');\n```\n\n\n#### Related Methods\n\n- [`.at(index) => ShallowWrapper`](at.md) - retrieve a wrapper node at given index\n- [`.last() => ShallowWrapper`](last.md)\n" }, { "path": "docs/api/ShallowWrapper/forEach.md", "content": "# `.forEach(fn) => Self`\n\nIterates through each node of the current wrapper and executes the provided function with a\nwrapper around the corresponding node passed in as the first argument.\n\n\n#### Arguments\n\n1. `fn` (`Function ( ShallowWrapper node, Number index )`): A callback to be run for every node in the collection.\nShould expect a ShallowWrapper as the first argument, and will be run with a context of the original\ninstance.\n\n\n\n#### Returns\n\n`ShallowWrapper`: Returns itself.\n\n\n\n#### Example\n\n```jsx\nconst wrapper = shallow((\n
\n
\n
\n
\n
\n));\n\nwrapper.find('.foo').forEach((node) => {\n expect(node.hasClass('foo')).to.equal(true);\n});\n```\n\n\n#### Related Methods\n\n- [`.map(fn) => ShallowWrapper`](map.md)\n" }, { "path": "docs/api/ShallowWrapper/get.md", "content": "# `.get(index) => ReactElement`\n\nReturns the node at a given index of the current wrapper.\n\n\n#### Arguments\n\n1. `index` (`Number`): A zero-based integer indicating which node to retrieve.\n\n\n#### Returns\n\n`ReactElement`: The retrieved node.\n\n\n#### Examples\n\n```jsx\nconst wrapper = shallow();\nexpect(wrapper.find(Foo).get(0).props.foo).to.equal('bar');\n```\n\n\n#### Related Methods\n\n- [`.at(index) => ShallowWrapper`](at.md) - same, but returns the React node in a single-node wrapper.\n" }, { "path": "docs/api/ShallowWrapper/getElement.md", "content": "# `.getElement() => ReactElement`\n\nReturns the wrapped ReactElement.\n\nIf the current wrapper is wrapping the root component, returns the root component's latest render output.\n\n\n#### Returns\n\n`ReactElement`: The retrieved ReactElement.\n\n\n\n#### Examples\n\n```jsx\nconst element = (\n
\n \n \n
\n);\n\nfunction MyComponent() {\n return element;\n}\n\nconst wrapper = shallow();\nexpect(wrapper.getElement()).to.equal(element);\n```\n\n\n\n#### Related Methods\n\n- [`.getElements() => Array`](getElements.md)\n" }, { "path": "docs/api/ShallowWrapper/getElements.md", "content": "# `.getElements() => Array`\n\nReturns the wrapped ReactElements\n\nIf the current wrapper is wrapping the root component, returns the root component's latest render output wrapped in an array.\n\n\n#### Returns\n\n`Array`: The retrieved ReactElements.\n\n\n\n#### Examples\n\n```jsx\nconst one = ;\nconst two = ;\n\nfunction Test() {\n return (\n
\n {one}\n {two}\n
\n );\n}\n\nconst wrapper = shallow();\nexpect(wrapper.find('span').getElements()).to.deep.equal([one, two]);\n```\n\n\n\n#### Related Methods\n\n- [`.getElement() => ReactElement`](getElement.md)\n" }, { "path": "docs/api/ShallowWrapper/getWrappingComponent.md", "content": "# `.getWrappingComponent() => ShallowWrapper`\n\nIf a `wrappingComponent` was passed in `options`, this methods returns a `ShallowWrapper` around the rendered `wrappingComponent`. This `ShallowWrapper` can be used to update the `wrappingComponent`'s props, state, etc.\n\n\n#### Returns\n\n`ShallowWrapper`: A `ShallowWrapper` around the rendered `wrappingComponent`\n\n\n\n#### Examples\n\n```jsx\nimport { Provider } from 'react-redux';\nimport { Router } from 'react-router';\nimport store from './my/app/store';\nimport mockStore from './my/app/mockStore';\n\nfunction MyProvider(props) {\n const { children, customStore } = props;\n\n return (\n \n \n {children}\n \n \n );\n}\nMyProvider.propTypes = {\n children: PropTypes.node,\n customStore: PropTypes.shape({}),\n};\nMyProvider.defaultProps = {\n children: null,\n customStore: null,\n};\n\nconst wrapper = shallow(, {\n wrappingComponent: MyProvider,\n});\nconst provider = wrapper.getWrappingComponent();\nprovider.setProps({ customStore: mockStore });\n```\n" }, { "path": "docs/api/ShallowWrapper/hasClass.md", "content": "# `.hasClass(className) => Boolean`\n\nReturns whether or not the wrapped node has a `className` prop including the passed in class name. It must be a single-node wrapper.\n\n\n#### Arguments\n\n1. `className` (`String` | `RegExp`): A single class name or a regex expression.\n\n\n#### Returns\n\n`Boolean`: whether or not the wrapped node has the class.\n\n\n#### Example\n\n\n```jsx\nconst wrapper = shallow();\nexpect(wrapper.find('.my-button').hasClass('disabled')).to.equal(true);\n```\n\n```jsx\n// Searching using RegExp works fine when classes were injected by a jss decorator\nconst wrapper = shallow();\nexpect(wrapper.find('.my-button').hasClass(/(ComponentName)-(other)-(\\d+)/)).to.equal(true);\n```\n\n### Common Gotchas\n\n- `.hasClass()` expects a class name, NOT a CSS selector. `.hasClass('.foo')` should be\n`.hasClass('foo')`\n" }, { "path": "docs/api/ShallowWrapper/hostNodes.md", "content": "# `.hostNodes() => ShallowWrapper`\n\nReturns a new wrapper with only host nodes.\nWhen using `react-dom`, host nodes are HTML elements rather than custom React components, e.g. `
` versus ``.\n\n\n#### Returns\n\n`ShallowWrapper`: A new wrapper that wraps the filtered nodes.\n\n\n#### Examples\n\nThe following code takes a wrapper with two nodes, one a `` React component, and the other a ``, and filters out the React component.\n\n```jsx\nconst wrapper = shallow((\n
\n \n \n
\n));\nconst twoNodes = wrapper.find('.foo');\nexpect(twoNodes.hostNodes()).to.have.lengthOf(1);\n```\n" }, { "path": "docs/api/ShallowWrapper/html.md", "content": "# `.html() => String`\n\nReturns a string of the rendered HTML markup of the entire current render tree (not just the shallow-rendered part). It uses [static rendering](../render.md) internally. To see only the shallow-rendered part use [`.debug()`](debug.md).\n\nNote: can only be called on a wrapper of a single node.\n\n\n#### Returns\n\n`String`: The resulting HTML string\n\n\n#### Examples\n\n```jsx\nfunction Foo() {\n return (
);\n}\n```\n\n```jsx\nfunction Bar() {\n return (\n
\n \n
\n );\n}\n```\n\n```jsx\nconst wrapper = shallow();\nexpect(wrapper.html()).to.equal('
');\nexpect(wrapper.find(Foo).html()).to.equal('
');\n```\n\n```jsx\nconst wrapper = shallow(
important
);\nexpect(wrapper.html()).to.equal('
important
');\n```\n\n\n#### Related Methods\n\n- [`.text() => String`](text.md)\n- [`.debug() => String`](debug.md)\n" }, { "path": "docs/api/ShallowWrapper/instance.md", "content": "# `.instance() => ReactComponent`\n\nReturns the single-node wrapper's node's underlying class instance; `this` in its methods. It must be a single-node wrapper.\n\nNOTE: can only be called on a wrapper instance that is also the root instance. With React `16` and above, `instance()` returns `null` for functional components, regardless of [hooks](https://reactjs.org/docs/hooks-intro.html) usage.\n\n#### Returns\n\n`ReactComponent|DOMComponent`: The retrieved instance.\n\n#### Example\n\n\n\n```jsx\nfunction SFC() {\n return
MyFunction
;\n}\n\nclass Stateful extends React.Component {\n render() {\n return
MyClass
;\n }\n}\n```\n\n#### React 16.x\n\n```jsx\ntest('wrapper instance is null', () => {\n const wrapper = shallow();\n const instance = wrapper.instance();\n\n expect(instance).to.equal(null);\n});\n\ntest('wrapper instance is not null', () => {\n const wrapper = shallow();\n const instance = wrapper.instance();\n\n expect(instance).to.be.instanceOf(MyCStatefullass);\n});\n```\n\n#### React 15.x\n\n```jsx\ntest('wrapper instance is not null', () => {\n const wrapper = shallow();\n const instance = wrapper.instance();\n\n expect(instance).to.be.instanceOf(SFC);\n});\n\ntest('wrapper instance is not null', () => {\n const wrapper = shallow();\n const instance = wrapper.instance();\n\n expect(instance).to.be.instanceOf(Stateful);\n});\n```\n" }, { "path": "docs/api/ShallowWrapper/invoke.md", "content": "# `.invoke(invokePropName)(...args) => Any`\n\nInvokes a function prop.\n\n#### Arguments\n\n1. `propName` (`String`): The function prop that is invoked\n2. `...args` (`Any` [optional]): Arguments that is passed to the prop function\n\nThis essentially calls wrapper.prop(propName)(...args).\n\n#### Returns\n\n`Any`: Returns the value from the prop function\n\n#### Example\n\n```jsx\nclass Foo extends React.Component {\n loadData() {\n return fetch();\n }\n\n render() {\n return (\n
\n this.loadData()}\n >\n Load more\n \n
\n );\n }\n}\nconst wrapper = shallow();\nwrapper.find('button').invoke('onClick')().then(() => {\n // expect()\n});\n```\n" }, { "path": "docs/api/ShallowWrapper/is.md", "content": "# `.is(selector) => Boolean`\n\nReturns whether or not the single wrapped node matches the provided selector. It must be a single-node wrapper.\n\n\n#### Arguments\n\n1. `selector` ([`EnzymeSelector`](../selector.md)): The selector to match.\n\n\n#### Returns\n\n`Boolean`: whether or not the wrapped node matches the provided selector.\n\n\n#### Example\n\n\n```jsx\nconst wrapper = shallow(
);\nexpect(wrapper.is('.some-class')).to.equal(true);\n```\n" }, { "path": "docs/api/ShallowWrapper/isEmpty.md", "content": "# `.isEmpty() => Boolean`\n**Deprecated**: Use [`.exists()`](exists.md) instead.\n\nReturns whether or not the wrapper is empty.\n\n\n#### Returns\n\n`Boolean`: whether or not the wrapper is empty.\n\n\n#### Example\n\n\n```jsx\nconst wrapper = shallow(
);\nexpect(wrapper.find('.other-class').isEmpty()).to.equal(true);\n```\n" }, { "path": "docs/api/ShallowWrapper/isEmptyRender.md", "content": "# `.isEmptyRender() => Boolean`\n\nReturns whether or not the wrapper would ultimately render only the allowed falsy values: `false` or `null`.\n\n#### Returns\n\n`Boolean`: whether the return is falsy\n\n#### Example\n\n```jsx\nfunction Foo() {\n return null;\n}\n\nconst wrapper = shallow();\nexpect(wrapper.isEmptyRender()).to.equal(true);\n```\n" }, { "path": "docs/api/ShallowWrapper/key.md", "content": "# `.key() => String`\n\nReturns the key value for the node of the current wrapper. It must be a single-node wrapper.\n\n#### Example\n\n\n```jsx\nconst wrapper = shallow((\n
    \n {['foo', 'bar'].map((s) =>
  • {s}
    • )}\n
\n)).find('li');\nexpect(wrapper.at(0).key()).to.equal('foo');\nexpect(wrapper.at(1).key()).to.equal('bar');\n```\n" }, { "path": "docs/api/ShallowWrapper/last.md", "content": "# `.last() => ShallowWrapper`\n\nReduce the set of matched nodes to the last in the set, just like `.at(length - 1)`.\n\n\n#### Returns\n\n`ShallowWrapper`: A new wrapper that wraps the last node in the set.\n\n\n#### Examples\n\n```jsx\nconst wrapper = shallow();\nexpect(wrapper.find(Foo).last().props().foo).to.equal('bar');\n```\n\n\n#### Related Methods\n\n- [`.at(index) => ShallowWrapper`](at.md) - retrieve a wrapper node by index\n- [`.first() => ShallowWrapper`](first.md)\n" }, { "path": "docs/api/ShallowWrapper/length.md", "content": "# `.length => number`\n\nReturns the number of React nodes enclosed in this wrapper.\n\n\n\n#### Returns\n\n`Number`: count of nodes in the list in this wrapper.\n\n\n\n#### Example\n\n\n```jsx\nconst wrapper = shallow(
);\nexpect(wrapper.length).to.equal(1);\n```\n" }, { "path": "docs/api/ShallowWrapper/map.md", "content": "# `.map(fn) => Array`\n\nMaps the current array of nodes to another array. Each node is passed in as a `ShallowWrapper`\nto the map function.\n\n\n#### Arguments\n\n1. `fn` (`Function ( ShallowWrapper node, Number index ) => Any`): A mapping function to be run for every node in\nthe collection, the results of which will be mapped to the returned array. Should expect a ShallowWrapper as the first argument, and will be run with a context of\nthe original instance.\n\n\n\n#### Returns\n\n`Array`: Returns an array of the returned values from the mapping function..\n\n\n\n#### Example\n\n```jsx\nconst wrapper = shallow((\n
\n
bax
\n
bar
\n
baz
\n
\n));\n\nconst texts = wrapper.find('.foo').map((node) => node.text());\nexpect(texts).to.eql(['bax', 'bar', 'baz']);\n```\n\n\n#### Related Methods\n\n- [`.forEach(fn) => ShallowWrapper`](forEach.md)\n- [`.reduce(fn[, initialValue]) => Any`](reduce.md)\n- [`.reduceRight(fn[, initialValue]) => Any`](reduceRight.md)\n" }, { "path": "docs/api/ShallowWrapper/matchesElement.md", "content": "# `.matchesElement(patternNode) => Boolean`\n\nReturns whether or not a given react element `patternNode` matches the wrapper's render tree. It must be a single-node wrapper, and only the root node is checked.\n\nThe `patternNode` acts like a wildcard. For it to match a node in the wrapper:\n* tag names must match\n* contents must match: In text nodes, leading and trailing spaces are ignored, but not space in the middle. Child elements must match according to these rules, recursively.\n* `patternNode` props (attributes) must appear in the wrapper's nodes, but not the other way around. Their values must match if they do appear.\n* `patternNode` style CSS properties must appear in the wrapper's node's style, but not the other way around. Their values must match if they do appear.\n\n\n#### Arguments\n\n1. `patternNode` (`ReactElement`): The node whose presence you are detecting in the wrapper's single node.\n\n\n#### Returns\n\n`Boolean`: whether or not the current wrapper match the one passed in.\n\n\n#### Example\n\n\n```jsx\nclass MyComponent extends React.Component {\n constructor(props) {\n super(props);\n this.handleClick = this.handleClick.bind(this);\n }\n\n handleClick() {\n // ...\n }\n\n render() {\n return (\n \n );\n }\n}\n\nconst wrapper = shallow();\nexpect(wrapper.matchesElement()).to.equal(true);\nexpect(wrapper.matchesElement()).to.equal(true);\n```\n\n\n#### Common Gotchas\n\n- `.matchesElement()` expects a ReactElement, not a selector (like many other methods). Make sure that\nwhen you are calling it you are calling it with a ReactElement or a JSX expression.\n- Keep in mind that this method determines matching based on the matching of the node's children as\nwell.\n\n\n#### Related Methods\n\n- [`.containsMatchingElement() => ShallowWrapper`](containsMatchingElement.md) - searches all nodes in the wrapper, and searches their entire depth\n" }, { "path": "docs/api/ShallowWrapper/name.md", "content": "# `.name() => String|null`\n\nReturns the name of the current node of this wrapper. If it's a composite component, this will be\nthe name of the top-most rendered component. If it's a native DOM node, it will be a string of the\ntag name. If it's `null`, it will be `null`.\n\nThe order of precedence on returning the name is: `type.displayName` -> `type.name` -> `type`.\n\nNote: can only be called on a wrapper of a single node.\n\n\n#### Returns\n\n`String|null`: The name of the current node\n\n\n\n#### Examples\n\n```jsx\nconst wrapper = shallow(
);\nexpect(wrapper.name()).to.equal('div');\n```\n\n```jsx\nfunction SomeWrappingComponent() {\n return ;\n}\nconst wrapper = shallow();\nexpect(wrapper.name()).to.equal('Foo');\n```\n\n```jsx\nFoo.displayName = 'A cool custom name';\nfunction SomeWrappingComponent() {\n return ;\n}\nconst wrapper = shallow();\nexpect(wrapper.name()).to.equal('A cool custom name');\n```\n" }, { "path": "docs/api/ShallowWrapper/not.md", "content": "# `.not(selector) => ShallowWrapper`\n\nReturns a new wrapper with only the nodes of the current wrapper that don't match the provided\nselector.\n\nThis method is effectively the negation or inverse of [`filter`](filter.md).\n\n\n#### Arguments\n\n1. `selector` ([`EnzymeSelector`](../selector.md)): The selector to match.\n\n\n\n#### Returns\n\n`ShallowWrapper`: A new wrapper that wraps the filtered nodes.\n\n\n\n#### Examples\n\n```jsx\nconst wrapper = shallow();\nexpect(wrapper.find('.foo').not('.bar')).to.have.lengthOf(1);\n```\n\n#### Related Methods\n\n- [`.filterWhere(predicate) => ShallowWrapper`](filterWhere.md)\n- [`.filter(selector) => ShallowWrapper`](filter.md)\n" }, { "path": "docs/api/ShallowWrapper/parent.md", "content": "# `.parent() => ShallowWrapper`\n\nReturns a wrapper with the direct parent of the node in the current wrapper.\n\n\n#### Returns\n\n`ShallowWrapper`: A new wrapper that wraps the resulting nodes.\n\n\n#### Examples\n\n```jsx\nconst wrapper = shallow();\nexpect(wrapper.find('ul').parent().is('div')).to.equal(true);\n```\n\n#### Related Methods\n\n- [`.parents([selector]) => ShallowWrapper`](parents.md)\n- [`.children([selector]) => ShallowWrapper`](children.md)\n- [`.closest(selector) => ShallowWrapper`](closest.md)\n" }, { "path": "docs/api/ShallowWrapper/parents.md", "content": "# `.parents([selector]) => ShallowWrapper`\n\nReturns a wrapper around all of the parents/ancestors of the single node in the wrapper. Does not include the node itself.\nOptionally, a selector can be provided and it will filter the parents by this selector. It must be a single-node wrapper.\n\n\n#### Arguments\n\n1. `selector` ([`EnzymeSelector`](../selector.md) [optional]): The selector to filter the parents by.\n\n\n#### Returns\n\n`ShallowWrapper`: A new wrapper that wraps the resulting nodes.\n\n\n#### Examples\n\n```jsx\nconst wrapper = shallow();\nexpect(wrapper.find('ul').parents()).to.have.lengthOf(2);\n```\n\n#### Related Methods\n\n- [`.children([selector]) => ShallowWrapper`](children.md)\n- [`.parent() => ShallowWrapper`](parent.md)\n- [`.closest(selector) => ShallowWrapper`](closest.md)\n" }, { "path": "docs/api/ShallowWrapper/prop.md", "content": "# `.prop(key) => Any`\n\nReturns the prop value for the root node of the wrapper with the provided key. It must be a single-node wrapper.\n\nNOTE: When called on a shallow wrapper, `.prop(key)` will return values for\nprops on the root node that the component *renders*, not the component itself.\nTo return the props for the entire React component, use `wrapper.instance().props`.\nSee [`.instance() => ReactComponent`](instance.md)\n\n#### Arguments\n\n1. `key` (`String`): The prop name, that is, `this.props[key]` or `props[key]` for the root node of the wrapper.\n\n\n#### Example\n\n\n```jsx\nimport PropTypes from 'prop-types';\nimport ValidateNumberInputComponent from './ValidateNumberInputComponent';\n\nclass MyComponent extends React.Component {\n constructor(...args) {\n super(...args);\n\n this.state = {\n number: 0,\n };\n this.onValidNumberInput = this.onValidNumberInput.bind(this);\n }\n\n onValidNumberInput(e) {\n const number = e.target.value;\n if (!number || typeof number === 'number') {\n this.setState({ number });\n }\n }\n\n render() {\n const { includedProp } = this.props;\n const { number } = this.state;\n return (\n
\n \n
\n );\n }\n}\nMyComponent.propTypes = {\n includedProp: PropTypes.string.isRequired,\n};\n\nconst wrapper = shallow();\nexpect(wrapper.prop('includedProp')).to.equal('Success!');\n\nconst validInput = 1;\nwrapper.find('ValidateNumberInputComponent').prop('onChangeHandler')(validInput);\nexpect(wrapper.state('number')).to.equal(validInput);\n\nconst invalidInput = 'invalid input';\nwrapper.find('ValidateNumberInputComponent').prop('onChangeHandler')(invalidInput);\nexpect(wrapper.state('number')).to.equal(0);\n\n// Warning: .prop(key) only returns values for props that exist in the root node.\n// See the note above about wrapper.instance().props to return all props in the React component.\n\nconsole.log(wrapper.prop('includedProp'));\n// \"Success!\"\n\nconsole.log(wrapper.prop('excludedProp'));\n// undefined\n\nconsole.log(wrapper.instance().props.excludedProp);\n// \"I'm not included\"\n```\n\n\n#### Related Methods\n\n- [`.props() => Object`](props.md)\n- [`.state([key]) => Any`](state.md)\n- [`.context([key]) => Any`](context.md)\n" }, { "path": "docs/api/ShallowWrapper/props.md", "content": "# `.props() => Object`\n\nReturns the props object for the root node of the wrapper. It must be a single-node wrapper.\n\nNOTE: When called on a shallow wrapper, `.props()` will return values for props on the root node that the component *renders*, not the component itself.\n\nThis method is a reliable way of accessing the props of a node; `wrapper.instance().props` will work as well, but in React 16+, stateless functional components do not have an instance. See [`.instance() => ReactComponent`](instance.md)\n\n\n#### Example\n```jsx\nimport PropTypes from 'prop-types';\n\nfunction MyComponent(props) {\n const { includedProp } = props;\n return (\n
Hello
\n );\n}\nMyComponent.propTypes = {\n includedProp: PropTypes.string.isRequired,\n};\n\nconst wrapper = shallow();\nexpect(wrapper.props().includedProp).to.equal('Success!');\n\n// Warning: .props() only returns props that are passed to the root node,\n// which does not include excludedProp in this example.\n// See the note above about wrapper.instance().props.\n\nconsole.log(wrapper.props());\n// {children: \"Hello\", className: \"foo bar\", includedProp=\"Success!\"}\n\nconsole.log(wrapper.instance().props); // React 15.x - working as expected\n// {children: \"Hello\", className: \"foo bar\", includedProp:\"Success!\", excludedProp: \"I'm not included\"}\n\nconsole.log(wrapper.instance().props);\n// React 16.* - Uncaught TypeError: Cannot read property 'props' of null\n```\n\n\n#### Related Methods\n\n- [`.prop(key) => Any`](prop.md)\n- [`.state([key]) => Any`](state.md)\n- [`.context([key]) => Any`](context.md)\n" }, { "path": "docs/api/ShallowWrapper/reduce.md", "content": "# `.reduce(fn[, initialValue]) => Any`\n\nApplies the provided reducing function to every node in the wrapper to reduce to a single value.\nEach node is passed in as a `ShallowWrapper`, and is processed from left to right.\n\n\n#### Arguments\n\n1. `fn` (`Function`): A reducing function to be run for every node in the collection, with the\nfollowing arguments:\n - `value` (`T`): The value returned by the previous invocation of this function\n - `node` (`ShallowWrapper`): A wrapper around the node being processed\n - `index` (`Number`): The index of the node being processed\n\n2. `initialValue` (`T` [optional]): If provided, this will be passed in as the first argument to the first invocation of the reducing function. If omitted, the first `node` will be provided and the iteration will begin on the second node in the collection.\n\n\n#### Returns\n\n`T`: Returns an array of the returned values from the mapping function...\n\n\n#### Example\n\n```jsx\nfunction Foo() {\n return (\n
\n \n \n \n
\n );\n}\n```\n\n```jsx\nconst wrapper = shallow();\nconst total = wrapper.find(Bar).reduce((amount, n) => amount + n.prop('amount'), 0);\nexpect(total).to.equal(14);\n```\n\n\n#### Related Methods\n\n- [`.reduceRight(fn[, initialValue]) => Any`](reduceRight.md)\n- [`.forEach(fn) => ShallowWrapper`](forEach.md)\n- [`.map(fn) => Array`](map.md)\n" }, { "path": "docs/api/ShallowWrapper/reduceRight.md", "content": "# `.reduceRight(fn[, initialValue]) => Any`\n\nApplies the provided reducing function to every node in the wrapper to reduce to a single value.\nEach node is passed in as a `ShallowWrapper`, and is processed from right to left.\n\n\n#### Arguments\n\n1. `fn` (`Function`): A reducing function to be run for every node in the collection, with the\nfollowing arguments:\n - `value` (`T`): The value returned by the previous invocation of this function\n - `node` (`ShallowWrapper`): A single-node wrapper around the node being processed\n - `index` (`Number`): The index of the node being processed\n\n2. `initialValue` (`T` [optional]): If provided, this will be passed in as the first argument to the first invocation of the reducing function. If omitted, the first `node` will be provided and the iteration will begin on the second node in the collection.\n\n\n#### Returns\n\n`T`: Returns an array of the returned values from the mapping function...\n\n\n#### Example\n\n```jsx\nfunction Foo() {\n return (\n
\n \n \n \n
\n );\n}\n```\n\n```jsx\nconst wrapper = shallow();\nconst total = wrapper.find(Bar).reduceRight((amount, n) => amount + n.prop('amount'), 0);\nexpect(total).to.equal(14);\n```\n\n\n#### Related Methods\n\n- [`.reduce(fn[, initialValue]) => Any`](reduce.md)\n- [`.forEach(fn) => ShallowWrapper`](forEach.md)\n- [`.map(fn) => Array`](map.md)\n" }, { "path": "docs/api/ShallowWrapper/render.md", "content": "# `.render() => CheerioWrapper`\n\nReturns a CheerioWrapper around the rendered HTML of the single node's subtree.\nIt must be a single-node wrapper.\n\n\n#### Returns\n\n`CheerioWrapper`: The resulting Cheerio object\n\n\n#### Examples\n\n```jsx\nfunction Foo() {\n return (
);\n}\n```\n\n```jsx\nfunction Bar() {\n return (\n
\n \n
\n );\n}\n```\n\n```jsx\nconst wrapper = shallow();\nexpect(wrapper.find('.in-foo')).to.have.lengthOf(0);\nexpect(wrapper.render().find('.in-foo')).to.have.lengthOf(1);\n```\n" }, { "path": "docs/api/ShallowWrapper/renderProp.md", "content": "# `.renderProp(propName)(...args) => ShallowWrapper`\n\nReturns a function that, when called with arguments `args`, will return a new wrapper based on the render prop in the original wrapper's prop `propName`.\n\nNOTE: can only be called on wrapper of a single non-DOM component element node.\n\n#### Arguments\n\n1. `propName` (`String`):\n1. `...args` (`Array`):\n\nThis essentially calls `wrapper.prop(propName)(...args)`.\n\n#### Returns\n\n`ShallowWrapper`: A new wrapper that wraps the node returned from the render prop.\n\n#### Examples\n\n##### Test Setup\n\n```jsx\nclass Mouse extends React.Component {\n constructor() {\n super();\n this.state = { x: 0, y: 0 };\n }\n\n render() {\n const { render } = this.props;\n return (\n {\n this.setState({\n x: event.clientX,\n y: event.clientY,\n });\n }}\n >\n {render(this.state)}\n
\n );\n }\n}\n\nMouse.propTypes = {\n render: PropTypes.func.isRequired,\n};\n```\n\n```jsx\nfunction App() {\n return (\n
\n (\n

\n The mouse position is ({x}, {y})\n

\n )}\n />\n
\n );\n}\n```\n\n##### Testing with no arguments\n\n```jsx\nconst wrapper = shallow()\n .find(Mouse)\n .renderProp('render')();\n\nexpect(wrapper.equals(

The mouse position is 0, 0

)).to.equal(true);\n```\n\n##### Testing with multiple arguments\n\n```jsx\nconst wrapper = shallow()\n .find(Mouse)\n .renderProp('render')(10, 20);\n\nexpect(wrapper.equals(

The mouse position is 10, 20

)).to.equal(true);\n```\n" }, { "path": "docs/api/ShallowWrapper/setContext.md", "content": "# `.setContext(context) => Self`\n\nA method that sets the context of the root component, and re-renders. Useful for when you are\nwanting to test how the component behaves over time with changing contexts.\n\nNOTE: can only be called on a wrapper instance that is also the root instance.\n\n\n#### Arguments\n\n1. `context` (`Object`): An object containing new props to merge in with the current state\n\n\n\n#### Returns\n\n`ShallowWrapper`: Returns itself.\n\n\n\n#### Example\n\n```jsx\nimport React from 'react';\nimport PropTypes from 'prop-types';\n\nfunction SimpleComponent(props, context) {\n const { name } = context;\n return
{name}
;\n}\nSimpleComponent.contextTypes = {\n name: PropTypes.string,\n};\n```\n```jsx\nconst context = { name: 'foo' };\nconst wrapper = shallow(, { context });\nexpect(wrapper.text()).to.equal('foo');\nwrapper.setContext({ name: 'bar' });\nexpect(wrapper.text()).to.equal('bar');\nwrapper.setContext({ name: 'baz' });\nexpect(wrapper.text()).to.equal('baz');\n```\n\n#### Common Gotchas\n\n- `.setContext()` can only be used on a wrapper that was initially created with a call to `shallow()`\nthat includes a `context` specified in the options argument.\n- The root component you are rendering must have a `contextTypes` static property.\n\n\n#### Related Methods\n\n- [`.setState(state[, callback]) => Self`](setState.md)\n- [`.setProps(props[, callback]) => Self`](setProps.md)\n\n\n" }, { "path": "docs/api/ShallowWrapper/setProps.md", "content": "# `.setProps(nextProps[, callback]) => Self`\n\nA method that sets the props of the root component, and re-renders. Useful for when you are\nwanting to test how the component behaves over time with changing props. Calling this, for\ninstance, will call the `componentWillReceiveProps` lifecycle method.\n\nSimilar to `setState`, this method accepts a props object and will merge it in with the already\nexisting props.\n\nNOTE: can only be called on a wrapper instance that is also the root instance.\n\n\n#### Arguments\n\n1. `nextProps` (`Object`): An object containing new props to merge in with the current props\n2. `callback` (`Function` [optional]): If provided, the callback function will be executed once setProps has completed\n\n\n#### Returns\n\n`ShallowWrapper`: Returns itself.\n\n\n#### Example\n\n```jsx\nimport React from 'react';\nimport PropTypes from 'prop-types';\n\nfunction Foo({ name }) {\n return (\n
\n );\n}\nFoo.propTypes = {\n name: PropTypes.string.isRequired,\n};\n```\n```jsx\nconst wrapper = shallow();\nexpect(wrapper.find('.foo')).to.have.lengthOf(1);\nexpect(wrapper.find('.bar')).to.have.lengthOf(0);\nwrapper.setProps({ name: 'bar' });\nexpect(wrapper.find('.foo')).to.have.lengthOf(0);\nexpect(wrapper.find('.bar')).to.have.lengthOf(1);\n```\n\n```jsx\nimport sinon from 'sinon';\n\nconst spy = sinon.spy(MyComponent.prototype, 'componentWillReceiveProps');\n\nconst wrapper = shallow();\nexpect(spy).to.have.property('callCount', 0);\nwrapper.setProps({ foo: 'foo' });\nexpect(spy).to.have.property('callCount', 1);\n```\n\n\n#### Related Methods\n\n- [`.setState(state) => Self`](setState.md)\n- [`.setContext(context) => Self`](setContext.md)\n" }, { "path": "docs/api/ShallowWrapper/setState.md", "content": "# `.setState(nextState[, callback]) => Self`\n\nA method to invoke `setState()` on the root component instance, similar to how you might in the\nmethods of the component, and re-renders. This method is useful for testing your component\nin hard-to-achieve states, however should be used sparingly. If possible, you should utilize\nyour component's external API (which is often accessible via [`.instance()`](instance.md)) in order\nto get it into whatever state you want to test, in order to be as accurate of a test as possible.\nThis is not always practical, however.\n\nNOTE: can only be called on a wrapper instance that is also the root instance.\n\n\n#### Arguments\n\n1. `nextState` (`Object`): An object containing new state to merge in with the current state\n2. `callback` (`Function` [optional]): If provided, the callback function will be executed once setState has completed\n\n\n#### Returns\n\n`ShallowWrapper`: Returns itself.\n\n\n#### Example\n\n```jsx\nclass Foo extends React.Component {\n constructor(props) {\n super(props);\n this.state = { name: 'foo' };\n }\n\n render() {\n const { name } = this.state;\n return (\n
\n );\n }\n}\n```\n```jsx\nconst wrapper = shallow();\nexpect(wrapper.find('.foo')).to.have.lengthOf(1);\nexpect(wrapper.find('.bar')).to.have.lengthOf(0);\nwrapper.setState({ name: 'bar' });\nexpect(wrapper.find('.foo')).to.have.lengthOf(0);\nexpect(wrapper.find('.bar')).to.have.lengthOf(1);\n```\n\n\n#### Related Methods\n\n- [`.setProps(props[, callback]) => Self`](setProps.md)\n- [`.setContext(context) => Self`](setContext.md)\n" }, { "path": "docs/api/ShallowWrapper/shallow.md", "content": "# `.shallow([options]) => ShallowWrapper`\n\nShallow renders the root node and returns a shallow wrapper around it.\nIt must be a single-node wrapper.\n\n\n#### Arguments\n\n1. `options` (`Object` [optional]):\n - `options.context`: (`Object` [optional]): Context to be passed into the component\n - `options.disableLifecycleMethods`: (`Boolean` [optional]): If set to true, `componentDidMount`\nis not called on the component, and `componentDidUpdate` is not called after\n[`setProps`](ShallowWrapper/setProps.md) and [`setContext`](ShallowWrapper/setContext.md). Default to `false`.\n\n\n#### Returns\n\n`ShallowWrapper`: A new wrapper that wraps the node after it's been shallow rendered.\n\n\n#### Examples\n\n```jsx\nfunction Bar() {\n return (\n
\n
\n
\n );\n}\n```\n\n```jsx\nfunction Foo() {\n return (\n
\n \n
\n );\n}\n```\n\n```jsx\nconst wrapper = shallow();\nexpect(wrapper.find('.in-bar')).to.have.lengthOf(0);\nexpect(wrapper.find(Bar)).to.have.lengthOf(1);\nexpect(wrapper.find(Bar).shallow().find('.in-bar')).to.have.lengthOf(1);\n```\n" }, { "path": "docs/api/ShallowWrapper/simulate.md", "content": "# `.simulate(event[, ...args]) => Self`\n\nSimulate events on the root node in the wrapper. It must be a single-node wrapper.\n\n\n#### Arguments\n\n1. `event` (`String`): The event name to be simulated\n2. `...args` (`Any` [optional]): A mock event object that will get passed through to the event handlers.\n\n\n#### Returns\n\n`ShallowWrapper`: Returns itself.\n\n\n#### Example `class component`\n\n```jsx\nclass Foo extends React.Component {\n constructor(props) {\n super(props);\n this.state = { count: 0 };\n }\n\n render() {\n const { count } = this.state;\n return (\n \n );\n }\n}\n\nconst wrapper = shallow();\n\nexpect(wrapper.find('.clicks-0').length).to.equal(1);\nwrapper.find('a').simulate('click');\nexpect(wrapper.find('.clicks-1').length).to.equal(1);\n```\n\n#### Example `functional component`\n\n```jsx\nfunction Foo({ width, height, onChange }) {\n return (\n
\n \n \n
\n );\n}\nFoo.propTypes = {\n width: PropTypes.number.isRequired,\n height: PropTypes.number.isRequired,\n onChange: PropTypes.func.isRequired,\n};\n\nconst testState = { width: 10, height: 20 };\nconst wrapper = shallow((\n {\n testState[e.target.name] = e.target.value;\n }}\n />\n));\n\nexpect(wrapper.find('input').at(0).prop('value')).toEqual(10);\nexpect(wrapper.find('input').at(1).prop('value')).toEqual(20);\nwrapper.find('input').at(0).simulate('change', { target: { name: 'width', value: 50 } });\nwrapper.find('input').at(1).simulate('change', { target: { name: 'height', value: 70 } });\nexpect(testState.width).toEqual(50);\nexpect(testState.height).toEqual(70);\n```\n\n#### Common Gotchas\n\n- Currently, event simulation for the shallow renderer does not propagate as one would normally\nexpect in a real environment. As a result, one must call `.simulate()` on the actual node that has\nthe event handler set.\n- Even though the name would imply this simulates an actual event, `.simulate()` will in fact\ntarget the component's prop based on the event you give it. For example, `.simulate('click')` will\nactually get the `onClick` prop and call it.\n- As noted in the function signature above passing a mock event is optional. Keep in mind that if the code you are testing uses the event for something like, calling `event.preventDefault()` or accessing any of its properties you must provide a mock event object with the properties your code requires.\n" }, { "path": "docs/api/ShallowWrapper/simulateError.md", "content": "# `.simulateError(error) => Self`\n\nSimulate a component throwing an error as part of its rendering lifecycle.\n\nThis is particularly useful in combination with React 16 error boundaries (ie, the `componentDidCatch` and `static getDerivedStateFromError` lifecycle methods).\n\n\n#### Arguments\n\n1. `error` (`Any`): The error to throw.\n\n\n\n#### Returns\n\n`ShallowWrapper`: Returns itself.\n\n\n\n#### Example\n\n```jsx\nfunction Something() {\n // this is just a placeholder\n return null;\n}\n\nclass ErrorBoundary extends React.Component {\n static getDerivedStateFromError(error) {\n return {\n hasError: true,\n };\n }\n\n constructor(props) {\n super(props);\n this.state = { hasError: false };\n }\n\n componentDidCatch(error, info) {\n const { spy } = this.props;\n spy(error, info);\n }\n\n render() {\n const { children } = this.props;\n const { hasError } = this.state;\n return (\n \n {hasError ? 'Error' : children}\n \n );\n }\n}\nErrorBoundary.propTypes = {\n children: PropTypes.node.isRequired,\n spy: PropTypes.func.isRequired,\n};\n\nconst spy = sinon.spy();\nconst wrapper = shallow();\nconst error = new Error('hi!');\nwrapper.find(Something).simulateError(error);\n\nexpect(wrapper.state()).to.have.property('hasError', true);\nexpect(spy).to.have.property('callCount', 1);\nexpect(spy.args).to.deep.equal([\n error,\n {\n componentStack: `\n in Something (created by ErrorBoundary)\n in ErrorBoundary (created by WrapperComponent)\n in WrapperComponent`,\n },\n]);\n```" }, { "path": "docs/api/ShallowWrapper/slice.md", "content": "# `.slice([begin[, end]]) => ShallowWrapper`\n\nReturns a new wrapper with a subset of the nodes of the original wrapper, according to the rules of `Array#slice`.\n\n\n#### Arguments\n\n1. `begin` (`Number` [optional]): Index from which to slice (defaults to `0`). If negative, this is treated as `length+begin`.\n1. `end` (`Number` [optional]): Index at which to end slicing (defaults to `length`). If negative, this is treated as `length+end`.\n\n\n\n#### Returns\n\n`ShallowWrapper`: A new wrapper with the subset of nodes specified.\n\n\n\n#### Examples\n\n```jsx\nconst wrapper = shallow((\n
\n
\n
\n
\n
\n));\nexpect(wrapper.find('.foo').slice(1)).to.have.lengthOf(2);\nexpect(wrapper.find('.foo').slice(1).at(0).hasClass('bar')).to.equal(true);\nexpect(wrapper.find('.foo').slice(1).at(1).hasClass('baz')).to.equal(true);\n```\n\n```jsx\nconst wrapper = shallow((\n
\n
\n
\n
\n
\n));\nexpect(wrapper.find('.foo').slice(1, 2)).to.have.lengthOf(1);\nexpect(wrapper.find('.foo').slice(1, 2).at(0).hasClass('bar')).to.equal(true);\n```\n" }, { "path": "docs/api/ShallowWrapper/some.md", "content": "# `.some(selector) => Boolean`\n\nReturns whether or not any of the nodes in the wrapper match the provided selector.\n\n\n#### Arguments\n\n1. `selector` ([`EnzymeSelector`](../selector.md)): The selector to match.\n\n\n\n#### Returns\n\n`Boolean`: True if at least one of the nodes in the current wrapper matched the provided selector.\n\n\n\n#### Examples\n\n```jsx\nconst wrapper = shallow((\n
\n
\n
\n
\n
\n));\nexpect(wrapper.find('.foo').some('.qoo')).to.equal(true);\nexpect(wrapper.find('.foo').some('.foo')).to.equal(true);\nexpect(wrapper.find('.foo').some('.bar')).to.equal(false);\n```\n\n#### Related Methods\n\n- [`.someWhere(predicate) => Boolean`](someWhere.md)\n- [`.every(selector) => Boolean`](every.md)\n- [`.everyWhere(predicate) => Boolean`](everyWhere.md)\n" }, { "path": "docs/api/ShallowWrapper/someWhere.md", "content": "# `.someWhere(fn) => Boolean`\n\nReturns whether or not any of the nodes in the wrapper pass the provided predicate function.\n\n\n#### Arguments\n\n1. `predicate` (`ShallowWrapper => Boolean`): A predicate function to match the nodes.\n\n\n\n#### Returns\n\n`Boolean`: True if at least one of the nodes in the current wrapper passed the predicate function.\n\n\n\n#### Example\n\n```jsx\nconst wrapper = shallow((\n
\n
\n
\n
\n
\n));\nexpect(wrapper.find('.foo').someWhere((n) => n.hasClass('qoo'))).to.equal(true);\nexpect(wrapper.find('.foo').someWhere((n) => n.hasClass('foo'))).to.equal(true);\nexpect(wrapper.find('.foo').someWhere((n) => n.hasClass('bar'))).to.equal(false);\n```\n\n\n#### Related Methods\n\n- [`.some(selector) => Boolean`](some.md)\n- [`.every(selector) => Boolean`](every.md)\n- [`.everyWhere(predicate) => Boolean`](everyWhere.md)\n" }, { "path": "docs/api/ShallowWrapper/state.md", "content": "# `.state([key]) => Any`\n\nReturns the state hash for the root node of the wrapper. Optionally pass in a prop name and it\nwill return just that value.\n\n\n#### Arguments\n\n1. `key` (`String` [optional]): If provided, the return value will be the `this.state[key]` of the\nroot component instance.\n\n\n\n#### Example\n\n\n```jsx\nconst wrapper = shallow();\nexpect(wrapper.state().foo).to.equal(10);\nexpect(wrapper.state('foo')).to.equal(10);\n```\n\n\n#### Related Methods\n\n- [`.props() => Object`](props.md)\n- [`.prop(key) => Any`](prop.md)\n- [`.context([key]) => Any`](context.md)\n" }, { "path": "docs/api/ShallowWrapper/tap.md", "content": "# `.tap(intercepter) => Self`\n\nInvokes intercepter and returns itself. intercepter is called with itself.\nThis is helpful when debugging nodes in method chains.\n\n#### Arguments\n\n1. `intercepter` (`Self`): the current ShallowWrapper instance.\n\n\n\n#### Returns\n\n`Self`: the current ShallowWrapper instance.\n\n\n\n#### Example\n\n\n```jsx\nconst result = shallow((\n
    \n
  • xxx
    • \n
  • yyy
    • \n
  • zzz
    • \n
\n)).find('li')\n .tap((n) => console.log(n.debug()))\n .map((n) => n.text());\n```\n" }, { "path": "docs/api/ShallowWrapper/text.md", "content": "# `.text() => String`\n\nReturns a string of the rendered text of the current render tree. This function should be\nlooked at with skepticism if being used to test what the actual HTML output of the component\nwill be. If that is what you would like to test, use enzyme's `render` function instead.\n\nNote: can only be called on a wrapper of a single node.\n\n\n#### Returns\n\n`String`: The resulting string\n\n\n#### Examples\n\n```jsx\nconst wrapper = shallow(
important
);\nexpect(wrapper.text()).to.equal('important');\n```\n\n```jsx\nconst wrapper = shallow(
important
);\nexpect(wrapper.text()).to.equal('important');\n```\n\n\n#### Related Methods\n\n[`.html() => String`](html.md)\n" }, { "path": "docs/api/ShallowWrapper/type.md", "content": "# `.type() => String | Function | null`\n\nReturns the type of the only node of this wrapper.\nIf it's a React component, this will be the component constructor.\nIf it's a native DOM node, it will be a string with the tag name.\nIf it's `null`, it will be `null`. It must be a single-node wrapper.\n\n\n#### Returns\n\n`String | Function | null`: The type of the node\n\n\n#### Examples\n\n```jsx\nfunction Foo() {\n return
;\n}\nconst wrapper = shallow();\nexpect(wrapper.type()).to.equal('div');\n```\n\n```jsx\nfunction Foo() {\n return (\n
\n \n
\n );\n}\nconst wrapper = shallow();\nexpect(wrapper.find('.btn').type()).to.equal('button');\n```\n\n```jsx\nfunction Foo() {\n return ;\n}\nconst wrapper = shallow();\nexpect(wrapper.type()).to.equal(Bar);\n```\n\n```jsx\nfunction Null() {\n return null;\n}\nconst wrapper = shallow();\nexpect(wrapper.type()).to.equal(null);\n```\n" }, { "path": "docs/api/ShallowWrapper/unmount.md", "content": "# `.unmount() => Self`\n\nA method that unmounts the component. This can be used to simulate a component going through\nan unmount/mount lifecycle.\n\n#### Returns\n\n`ShallowWrapper`: Returns itself.\n\n\n\n#### Example\n\n```jsx\nimport PropTypes from 'prop-types';\nimport sinon from 'sinon';\n\nconst spy = sinon.spy();\n\nclass Foo extends React.Component {\n constructor(props) {\n super(props);\n this.componentWillUnmount = spy;\n }\n\n render() {\n const { id } = this.props;\n return (\n
\n {id}\n
\n );\n }\n}\nFoo.propTypes = {\n id: PropTypes.string.isRequired,\n};\nconst wrapper = shallow();\nexpect(spy).to.have.property('callCount', 0);\nwrapper.unmount();\nexpect(spy).to.have.property('callCount', 1);\n```\n" }, { "path": "docs/api/ShallowWrapper/update.md", "content": "# `.update() => Self`\n\nSyncs the enzyme component tree snapshot with the react component tree. Useful to run before checking the render output if something external\nmay be updating the state of the component somewhere.\n\nNOTE: no matter what instance this is called on, it will always update the root.\n\nNOTE: only updates Enzyme's representation of rendered tree.\n\nNOTE: this does not force a re-render. Use `wrapper.setProps({})` to force a re-render.\n\n\n#### Returns\n\n`ReactWrapper`: Returns itself.\n\n\n\n#### Example\n\n```jsx\nclass UpdateEnzyme extends React.Component {\n constructor(props) {\n super(props);\n this.state = {\n count: 0,\n };\n this.increment = this.increment.bind(this);\n }\n\n increment() {\n const { count } = this.state;\n this.setState({ count: count + 1 });\n }\n\n render() {\n const { count } = this.state;\n return ;\n }\n}\n```\n```jsx\nconst wrapper = shallow();\nexpect(wrapper.find('button.increment').text()).to.equal('0');\nwrapper.instance().increment();\n\n// Update Enzyme's view of output\nwrapper.update();\n\nexpect(wrapper.find('button.increment').text()).to.equal('1');\n```\n" }, { "path": "docs/api/mount.md", "content": "# Full Rendering API (`mount(...)`)\n\nFull DOM rendering is ideal for use cases where you have components that may interact with DOM APIs or need to test components that are wrapped in higher order components.\n\nFull DOM rendering requires that a full DOM API be available at the global scope. This means that\nit must be run in an environment that at least “looks like” a browser environment. If you do not\nwant to run your tests inside of a browser, the recommended approach to using `mount` is to depend\non a library called [jsdom](https://github.com/jsdom/jsdom) which is essentially a headless browser\nimplemented completely in JS.\n\n**Note**: unlike shallow or static rendering, full rendering actually mounts the component in the DOM, which means that tests can affect each other if they are all using the same DOM. Keep that in mind while writing your tests and, if necessary, use [`.unmount()`](ReactWrapper/unmount.md) or something similar as cleanup.\n\n```jsx\nimport { mount } from 'enzyme';\nimport sinon from 'sinon';\nimport Foo from './Foo';\n\ndescribe('', () => {\n it('calls componentDidMount', () => {\n sinon.spy(Foo.prototype, 'componentDidMount');\n const wrapper = mount();\n expect(Foo.prototype.componentDidMount).to.have.property('callCount', 1);\n });\n\n it('allows us to set props', () => {\n const wrapper = mount();\n expect(wrapper.props().bar).to.equal('baz');\n wrapper.setProps({ bar: 'foo' });\n expect(wrapper.props().bar).to.equal('foo');\n });\n\n it('simulates click events', () => {\n const onButtonClick = sinon.spy();\n const wrapper = mount((\n \n ));\n wrapper.find('button').simulate('click');\n expect(onButtonClick).to.have.property('callCount', 1);\n });\n});\n```\n\n## `mount(node[, options]) => ReactWrapper`\n\n#### Arguments\n\n1. `node` (`ReactElement`): The node to render\n2. `options` (`Object` [optional]):\n- `options.context`: (`Object` [optional]): Context to be passed into the component\n- `options.attachTo`: (`DOMElement` [optional]): DOM Element to attach the component to.\n- `options.childContextTypes`: (`Object` [optional]): Merged contextTypes for all children of the wrapper.\n- `options.wrappingComponent`: (`ComponentType` [optional]): A component that will render as a parent of the `node`. It can be used to provide context to the `node`, among other things. See the [`getWrappingComponent()` docs](ReactWrapper/getWrappingComponent.md) for an example. **Note**: `wrappingComponent` _must_ render its children.\n- `options.wrappingComponentProps`: (`Object` [optional]): Initial props to pass to the `wrappingComponent` if it is specified.\n\n#### Returns\n\n`ReactWrapper`: The wrapper instance around the rendered output.\n\n\n## ReactWrapper API\n\n#### [`.find(selector) => ReactWrapper`](ReactWrapper/find.md)\nFind every node in the render tree that matches the provided selector.\n\n#### [`.findWhere(predicate) => ReactWrapper`](ReactWrapper/findWhere.md)\nFind every node in the render tree that returns true for the provided predicate function.\n\n#### [`.filter(selector) => ReactWrapper`](ReactWrapper/filter.md)\nRemove nodes in the current wrapper that do not match the provided selector.\n\n#### [`.filterWhere(predicate) => ReactWrapper`](ReactWrapper/filterWhere.md)\nRemove nodes in the current wrapper that do not return true for the provided predicate function.\n\n#### [`.hostNodes() => ReactWrapper`](ReactWrapper/hostNodes.md)\nRemoves nodes that are not host nodes; e.g., this will only return HTML nodes.\n\n#### [`.contains(nodeOrNodes) => Boolean`](ReactWrapper/contains.md)\nReturns whether or not a given node or array of nodes exists in the render tree.\n\n#### [`.containsMatchingElement(node) => Boolean`](ReactWrapper/containsMatchingElement.md)\nReturns whether or not a given react element exists in the render tree.\n\n#### [`.containsAllMatchingElements(nodes) => Boolean`](ReactWrapper/containsAllMatchingElements.md)\nReturns whether or not all the given react elements exist in the render tree.\n\n#### [`.containsAnyMatchingElements(nodes) => Boolean`](ReactWrapper/containsAnyMatchingElements.md)\nReturns whether or not one of the given react elements exist in the render tree.\n\n#### [`.equals(node) => Boolean`](ReactWrapper/equals.md)\nReturns whether or not the current wrapper root node render tree looks like the one passed in.\n\n#### [`.hasClass(className) => Boolean`](ReactWrapper/hasClass.md)\nReturns whether or not the current root node has the given class name or not.\n\n#### [`.is(selector) => Boolean`](ReactWrapper/is.md)\nReturns whether or not the current node matches a provided selector.\n\n#### [`.exists([selector]) => Boolean`](ReactWrapper/exists.md)\nReturns whether or not the current node exists, or, if given a selector, whether that selector has any matching results.\n\n#### [`.isEmpty() => Boolean`](ReactWrapper/isEmpty.md)\n*Deprecated*: Use [`.exists()`](ReactWrapper/exists.md) instead.\n\n#### [`.isEmptyRender() => Boolean`](ReactWrapper/isEmptyRender.md)\nReturns whether or not the current component returns a falsy value.\n\n#### [`.not(selector) => ReactWrapper`](ReactWrapper/not.md)\nRemove nodes in the current wrapper that match the provided selector. (inverse of `.filter()`)\n\n#### [`.children([selector]) => ReactWrapper`](ReactWrapper/children.md)\nGet a wrapper with all of the children nodes of the current wrapper.\n\n#### [`.childAt(index) => ReactWrapper`](ReactWrapper/childAt.md)\nReturns a new wrapper with child at the specified index.\n\n#### [`.parents([selector]) => ReactWrapper`](ReactWrapper/parents.md)\nGet a wrapper with all of the parents (ancestors) of the current node.\n\n#### [`.parent() => ReactWrapper`](ReactWrapper/parent.md)\nGet a wrapper with the direct parent of the current node.\n\n#### [`.closest(selector) => ReactWrapper`](ReactWrapper/closest.md)\nGet a wrapper with the first ancestor of the current node to match the provided selector.\n\n#### [`.render() => CheerioWrapper`](ReactWrapper/render.md)\nReturns a CheerioWrapper of the current node's subtree.\n\n#### [`.renderProp(key)() => ReactWrapper`](ReactWrapper/renderProp.md)\nReturns a wrapper of the node rendered by the provided render prop.\n\n#### [`.text() => String`](ReactWrapper/text.md)\nReturns a string representation of the text nodes in the current render tree.\n\n#### [`.html() => String`](ReactWrapper/html.md)\nReturns a static HTML rendering of the current node.\n\n#### [`.get(index) => ReactElement`](ReactWrapper/get.md)\nReturns the node at the provided index of the current wrapper.\n\n#### [`.getDOMNode() => DOMComponent`](ReactWrapper/getDOMNode.md)\nReturns the outer most DOMComponent of the current wrapper.\n\n#### [`.getElement() => ReactElement`](ReactWrapper/getElement.md)\nReturns the wrapped ReactElement.\n\n#### [`.getElements() => Array`](ReactWrapper/getElements.md)\nReturns the wrapped ReactElements.\n\n#### [`.at(index) => ReactWrapper`](ReactWrapper/at.md)\nReturns a wrapper of the node at the provided index of the current wrapper.\n\n#### [`.first() => ReactWrapper`](ReactWrapper/first.md)\nReturns a wrapper of the first node of the current wrapper.\n\n#### [`.last() => ReactWrapper`](ReactWrapper/last.md)\nReturns a wrapper of the last node of the current wrapper.\n\n#### [`.state([key]) => Any`](ReactWrapper/state.md)\nReturns the state of the root component.\n\n#### [`.context([key]) => Any`](ReactWrapper/context.md)\nReturns the context of the root component.\n\n#### [`.props() => Object`](ReactWrapper/props.md)\nReturns the props of the root component.\n\n#### [`.prop(key) => Any`](ReactWrapper/prop.md)\nReturns the named prop of the root component.\n\n#### [`.invoke(propName)(...args) => Any`](ReactWrapper/invoke.md)\nInvokes a prop function on the current node and returns the function's return value.\n\n#### [`.key() => String`](ReactWrapper/key.md)\nReturns the key of the root component.\n\n#### [`.simulate(event[, mock]) => ReactWrapper`](ReactWrapper/simulate.md)\nSimulates an event on the current node.\n\n#### [`.setState(nextState) => ReactWrapper`](ReactWrapper/setState.md)\nManually sets state of the root component.\n\n#### [`.setProps(nextProps[, callback]) => ReactWrapper`](ReactWrapper/setProps.md)\nManually sets props of the root component.\n\n#### [`.setContext(context) => ReactWrapper`](ReactWrapper/setContext.md)\nManually sets context of the root component.\n\n#### [`.instance() => ReactComponent|DOMComponent`](ReactWrapper/instance.md)\nReturns the wrapper's underlying instance.\n\n#### [`.getWrappingComponent() => ReactWrapper`](ReactWrapper/getWrappingComponent.md)\nReturns a wrapper representing the `wrappingComponent`, if one was passed.\n\n#### [`.unmount() => ReactWrapper`](ReactWrapper/unmount.md)\nA method that un-mounts the component.\n\n#### [`.mount() => ReactWrapper`](ReactWrapper/mount.md)\nA method that re-mounts the component.\n\n#### [`.update() => ReactWrapper`](ReactWrapper/update.md)\nSyncs the enzyme component tree snapshot with the react component tree.\n\n#### [`.debug() => String`](ReactWrapper/debug.md)\nReturns a string representation of the current render tree for debugging purposes.\n\n#### [`.type() => String|Function`](ReactWrapper/type.md)\nReturns the type of the current node of the wrapper.\n\n#### [`.name() => String`](ReactWrapper/name.md)\nReturns the name of the current node of the wrapper.\n\n#### [`.forEach(fn) => ReactWrapper`](ReactWrapper/forEach.md)\nIterates through each node of the current wrapper and executes the provided function\n\n#### [`.map(fn) => Array`](ReactWrapper/map.md)\nMaps the current array of nodes to another array.\n\n#### [`.matchesElement(node) => Boolean`](ReactWrapper/matchesElement.md)\nReturns whether or not a given react element matches the current render tree.\n\n#### [`.reduce(fn[, initialValue]) => Any`](ReactWrapper/reduce.md)\nReduces the current array of nodes to a value\n\n#### [`.reduceRight(fn[, initialValue]) => Any`](ReactWrapper/reduceRight.md)\nReduces the current array of nodes to a value, from right to left.\n\n#### [`.slice([begin[, end]]) => ReactWrapper`](ReactWrapper/slice.md)\nReturns a new wrapper with a subset of the nodes of the original wrapper, according to the rules of `Array#slice`.\n\n#### [`.tap(intercepter) => Self`](ReactWrapper/tap.md)\nTaps into the wrapper method chain. Helpful for debugging.\n\n#### [`.some(selector) => Boolean`](ReactWrapper/some.md)\nReturns whether or not any of the nodes in the wrapper match the provided selector.\n\n#### [`.someWhere(predicate) => Boolean`](ReactWrapper/someWhere.md)\nReturns whether or not any of the nodes in the wrapper pass the provided predicate function.\n\n#### [`.every(selector) => Boolean`](ReactWrapper/every.md)\nReturns whether or not all of the nodes in the wrapper match the provided selector.\n\n#### [`.everyWhere(predicate) => Boolean`](ReactWrapper/everyWhere.md)\nReturns whether or not all of the nodes in the wrapper pass the provided predicate function.\n\n#### [`.ref(refName) => ReactComponent | HTMLElement`](ReactWrapper/ref.md)\nReturns the node that matches the provided reference name.\n\n#### [`.detach() => void`](ReactWrapper/detach.md)\nUnmount the component from the DOM node it's attached to.\n" }, { "path": "docs/api/render.md", "content": "# Static Rendering API\n\nUse enzyme's `render` function to generate HTML from your React tree, and analyze the resulting HTML structure.\n\n`render` returns a wrapper very similar to the other renderers in enzyme, [`mount`](mount.md) and\n[`shallow`](shallow.md); however, `render` uses a third party HTML parsing and traversal library\n[Cheerio](https://cheerio.js.org). We believe that Cheerio handles parsing and\ntraversing HTML extremely well, and duplicating this functionality ourselves would be a\ndisservice.\n\nFor the purposes of this documentation, we will refer to Cheerio's constructor as\n`CheerioWrapper`, which is to say that it is analogous to our `ReactWrapper` and `ShallowWrapper`\nconstructors. You can reference the [Cheerio API docs](https://github.com/cheeriojs/cheerio#api) for methods available on a `CheerioWrapper` instance.\n\n### Example Usage\n\n```jsx\nimport React from 'react';\nimport { render } from 'enzyme';\nimport PropTypes from 'prop-types';\n\ndescribe('', () => {\n it('renders three `.foo-bar`s', () => {\n const wrapper = render();\n expect(wrapper.find('.foo-bar')).to.have.lengthOf(3);\n });\n\n it('rendered the title', () => {\n const wrapper = render();\n expect(wrapper.text()).to.contain('unique');\n });\n\n it('renders a div', () => {\n const wrapper = render(
);\n expect(wrapper.html()).to.contain('div');\n });\n\n it('can pass in context', () => {\n function SimpleComponent(props, context) {\n const { name } = context;\n return
{name}
;\n }\n SimpleComponent.contextTypes = {\n name: PropTypes.string,\n };\n\n const context = { name: 'foo' };\n const wrapper = render(, { context });\n expect(wrapper.text()).to.equal('foo');\n });\n});\n```\n" }, { "path": "docs/api/selector.md", "content": "# enzyme Selectors\n\nMany methods in enzyme’s API accept a *selector* as an argument.\nYou can select several different ways:\n\n### 1. A Valid CSS Selector\n\nenzyme supports a subset of valid CSS selectors to find nodes inside a render tree. Support is as\nfollows:\n\n- class syntax (`.foo`, `.foo-bar`, etc.)\n- element tag name syntax (`input`, `div`, `span`, etc.)\n- id syntax (`#foo`, `#foo-bar`, etc.)\n- attribute syntax (`[href=\"foo\"]`, `[type=\"text\"]`, and the other attribute selectors listed [here](https://developer.mozilla.org/en-US/docs/Learn/CSS/Introduction_to_CSS/Attribute_selectors).)\n- universal syntax (`*`)\n- React component name and props (`Button`, `Button[type=\"submit\"]`, etc) - however, please note that it is strongly encouraged to find by component constructor/function and not by display name.\n\nThe attribute syntax also works by value, rather than by string. Strings, numbers, and boolean property values are supported. Example:\n\n```js\nconst wrapper = mount((\n
\n \n \n
\n));\n```\n\nThe selector `[anum=3]` will select the first but not the second, because there's no quotes surrounding the 3. The selector `[anum=\"3\"]` will select the second, because it's explicitly looking for a string because of the quotes surrounding 3. The same goes for the boolean; [abool=false] will select the first but not the second, etc.\n\nFurther, enzyme supports combining any of those supported syntaxes together, as with CSS:\n\n```css\ndiv.foo.bar\ninput#input-name\na[href=\"foo\"]\n.foo .bar\n.foo > .bar\n.foo + .bar\n.foo ~ .bar\n.foo input\n```\n\n**React Key and Ref Props**\n\nWhile in most cases, any React prop can be used, there are exceptions.\nThe `key` and `ref` props will never work; React uses these props internally.\n\n\n**Want more CSS support?**\n\nPRs implementing more support for CSS selectors will be accepted and is an area of development for\nenzyme that will likely be focused on in the future.\n\n\n### 2. A React Component Constructor\n\nenzyme allows you to find React components based on their constructor. You can pass in the reference to\nthe component’s constructor.\nOf course, this kind of selector only checks the component type; it ignores props and children.\n\n```jsx\nfunction MyComponent() {\n return
;\n}\n\n// find instances of MyComponent\nconst myComponents = wrapper.find(MyComponent);\n```\n\n\n### 3. A React Component’s displayName\n\nenzyme allows you to find components based on a component’s `displayName`. If a component exists\nin a render tree where its `displayName` is set and has its first character as a capital letter,\nyou can use a string to find it:\n\n\n```jsx\nfunction MyComponent() {\n return
;\n}\nMyComponent.displayName = 'My Component';\n\n// find instances of MyComponent\nconst myComponents = wrapper.find('My Component');\n```\n\nNOTE: This will *only* work if the selector (and thus the component’s `displayName`) is a string\nstarting with a capital letter. Strings starting with lower case letters will be assumed to be a CSS\nselector (therefore a tag name).\n\nSelecting a HOC-wrapped component, or a component with a custom `displayName`, even with lowercase letters (for example, `withHOC(MyComponent)`) will work as well.\n\n\n### 4. Object Property Selector\n\nenzyme allows you to find components and nodes based on a subset of their properties:\n\n\n```jsx\nconst wrapper = mount((\n
\n \n
\n));\n\nwrapper.find({ foo: 3 });\nwrapper.find({ bar: false });\nwrapper.find({ title: 'baz' });\n```\n\n**Undefined Properties**\n\nUndefined properties are not allowed in the object property selector and will cause an error:\n\n\n```jsx\nwrapper.find({ foo: 3, bar: undefined });\n// => TypeError: Enzyme::Props can't have 'undefined' values. Try using 'findWhere()' instead.\n```\n\nIf you have to search by `undefined` property value, use [`.findWhere()`](ShallowWrapper/findWhere.md).\n" }, { "path": "docs/api/shallow.md", "content": "# Shallow Rendering API\n\nShallow rendering is useful to constrain yourself to testing a component as a unit, and to ensure\nthat your tests aren't indirectly asserting on behavior of child components.\n\nAs of Enzyme v3, the `shallow` API does call React lifecycle methods such as `componentDidMount` and `componentDidUpdate`. You can read more about this in the [version 3 migration guide](../guides/migration-from-2-to-3.md#lifecycle-methods).\n\n```jsx\nimport { shallow } from 'enzyme';\nimport sinon from 'sinon';\nimport Foo from './Foo';\n\ndescribe('', () => {\n it('renders three components', () => {\n const wrapper = shallow();\n expect(wrapper.find(Foo)).to.have.lengthOf(3);\n });\n\n it('renders an `.icon-star`', () => {\n const wrapper = shallow();\n expect(wrapper.find('.icon-star')).to.have.lengthOf(1);\n });\n\n it('renders children when passed in', () => {\n const wrapper = shallow((\n \n
\n \n ));\n expect(wrapper.contains(
)).to.equal(true);\n });\n\n it('simulates click events', () => {\n const onButtonClick = sinon.spy();\n const wrapper = shallow();\n wrapper.find('button').simulate('click');\n expect(onButtonClick).to.have.property('callCount', 1);\n });\n});\n```\n\n## `shallow(node[, options]) => ShallowWrapper`\n\n#### Arguments\n\n1. `node` (`ReactElement`): The node to render\n2. `options` (`Object` [optional]):\n - `options.context`: (`Object` [optional]): Context to be passed into the component\n - `options.disableLifecycleMethods`: (`Boolean` [optional]): If set to true, `componentDidMount`\nis not called on the component, and `componentDidUpdate` is not called after\n[`setProps`](ShallowWrapper/setProps.md) and [`setContext`](ShallowWrapper/setContext.md). Default to `false`.\n - `options.wrappingComponent`: (`ComponentType` [optional]): A component that will render as a parent of the `node`. It can be used to provide context to the `node`, among other things. See the [`getWrappingComponent()` docs](ShallowWrapper/getWrappingComponent.md) for an example. **Note**: `wrappingComponent` _must_ render its children.\n - `options.wrappingComponentProps`: (`Object` [optional]): Initial props to pass to the `wrappingComponent` if it is specified.\n - `options.suspenseFallback`: (`Boolean` [optional]): If set to true, when rendering `Suspense` enzyme will replace all the lazy components in children with `fallback` element prop. Otherwise it won't handle fallback of lazy component. Default to `true`. Note: not supported in React < 16.6.\n\n#### Returns\n\n`ShallowWrapper`: The wrapper instance around the rendered output.\n\n\n## ShallowWrapper API\n\n#### [`.find(selector) => ShallowWrapper`](ShallowWrapper/find.md)\nFind every node in the render tree that matches the provided selector.\n\n#### [`.findWhere(predicate) => ShallowWrapper`](ShallowWrapper/findWhere.md)\nFind every node in the render tree that returns true for the provided predicate function.\n\n#### [`.filter(selector) => ShallowWrapper`](ShallowWrapper/filter.md)\nRemove nodes in the current wrapper that do not match the provided selector.\n\n#### [`.filterWhere(predicate) => ShallowWrapper`](ShallowWrapper/filterWhere.md)\nRemove nodes in the current wrapper that do not return true for the provided predicate function.\n\n#### [`.hostNodes() => ShallowWrapper`](ShallowWrapper/hostNodes.md)\nRemoves nodes that are not host nodes; e.g., this will only return HTML nodes.\n\n#### [`.contains(nodeOrNodes) => Boolean`](ShallowWrapper/contains.md)\nReturns whether or not a given node or array of nodes is somewhere in the render tree.\n\n#### [`.containsMatchingElement(node) => Boolean`](ShallowWrapper/containsMatchingElement.md)\nReturns whether or not a given react element exists in the shallow render tree.\n\n#### [`.containsAllMatchingElements(nodes) => Boolean`](ShallowWrapper/containsAllMatchingElements.md)\nReturns whether or not all the given react elements exist in the shallow render tree.\n\n#### [`.containsAnyMatchingElements(nodes) => Boolean`](ShallowWrapper/containsAnyMatchingElements.md)\nReturns whether or not one of the given react elements exists in the shallow render tree.\n\n#### [`.equals(node) => Boolean`](ShallowWrapper/equals.md)\nReturns whether or not the current render tree is equal to the given node, based on the expected value.\n\n#### [`.matchesElement(node) => Boolean`](ShallowWrapper/matchesElement.md)\nReturns whether or not a given react element matches the shallow render tree.\n\n#### [`.hasClass(className) => Boolean`](ShallowWrapper/hasClass.md)\nReturns whether or not the current node has the given class name or not.\n\n#### [`.is(selector) => Boolean`](ShallowWrapper/is.md)\nReturns whether or not the current node matches a provided selector.\n\n#### [`.exists([selector]) => Boolean`](ShallowWrapper/exists.md)\nReturns whether or not the current node exists, or, if given a selector, whether that selector has any matching results.\n\n#### [`.isEmpty() => Boolean`](ShallowWrapper/isEmpty.md)\n*Deprecated*: Use [`.exists()`](ShallowWrapper/exists.md) instead.\n\n#### [`.isEmptyRender() => Boolean`](ShallowWrapper/isEmptyRender.md)\nReturns whether or not the current component returns a falsy value.\n\n#### [`.not(selector) => ShallowWrapper`](ShallowWrapper/not.md)\nRemove nodes in the current wrapper that match the provided selector. (inverse of `.filter()`)\n\n#### [`.children([selector]) => ShallowWrapper`](ShallowWrapper/children.md)\nGet a wrapper with all of the children nodes of the current wrapper.\n\n#### [`.childAt(index) => ShallowWrapper`](ShallowWrapper/childAt.md)\nReturns a new wrapper with child at the specified index.\n\n#### [`.parents([selector]) => ShallowWrapper`](ShallowWrapper/parents.md)\nGet a wrapper with all of the parents (ancestors) of the current node.\n\n#### [`.parent() => ShallowWrapper`](ShallowWrapper/parent.md)\nGet a wrapper with the direct parent of the current node.\n\n#### [`.closest(selector) => ShallowWrapper`](ShallowWrapper/closest.md)\nGet a wrapper with the first ancestor of the current node to match the provided selector.\n\n#### [`.shallow([options]) => ShallowWrapper`](ShallowWrapper/shallow.md)\nShallow renders the current node and returns a shallow wrapper around it.\n\n#### [`.render() => CheerioWrapper`](ShallowWrapper/render.md)\nReturns a CheerioWrapper of the current node's subtree.\n\n#### [`.renderProp(key)() => ShallowWrapper`](ShallowWrapper/renderProp.md)\nReturns a wrapper of the node rendered by the provided render prop.\n\n#### [`.unmount() => ShallowWrapper`](ShallowWrapper/unmount.md)\nA method that un-mounts the component.\n\n#### [`.text() => String`](ShallowWrapper/text.md)\nReturns a string representation of the text nodes in the current render tree.\n\n#### [`.html() => String`](ShallowWrapper/html.md)\nReturns a static HTML rendering of the current node.\n\n#### [`.get(index) => ReactElement`](ShallowWrapper/get.md)\nReturns the node at the provided index of the current wrapper.\n\n#### [`.getElement() => ReactElement`](ShallowWrapper/getElement.md)\nReturns the wrapped ReactElement.\n\n#### [`.getElements() => Array`](ShallowWrapper/getElements.md)\nReturns the wrapped ReactElements.\n\n#### [`.at(index) => ShallowWrapper`](ShallowWrapper/at.md)\nReturns a wrapper of the node at the provided index of the current wrapper.\n\n#### [`.first() => ShallowWrapper`](ShallowWrapper/first.md)\nReturns a wrapper of the first node of the current wrapper.\n\n#### [`.last() => ShallowWrapper`](ShallowWrapper/last.md)\nReturns a wrapper of the last node of the current wrapper.\n\n#### [`.state([key]) => Any`](ShallowWrapper/state.md)\nReturns the state of the root component.\n\n#### [`.context([key]) => Any`](ShallowWrapper/context.md)\nReturns the context of the root component.\n\n#### [`.props() => Object`](ShallowWrapper/props.md)\nReturns the props of the current node.\n\n#### [`.prop(key) => Any`](ShallowWrapper/prop.md)\nReturns the named prop of the current node.\n\n#### [`.key() => String`](ShallowWrapper/key.md)\nReturns the key of the current node.\n\n#### [`.invoke(propName)(...args) => Any`](ShallowWrapper/invoke.md)\nInvokes a prop function on the current node and returns the function's return value.\n\n#### [`.simulate(event[, data]) => ShallowWrapper`](ShallowWrapper/simulate.md)\nSimulates an event on the current node.\n\n#### [`.setState(nextState) => ShallowWrapper`](ShallowWrapper/setState.md)\nManually sets state of the root component.\n\n#### [`.setProps(nextProps[, callback]) => ShallowWrapper`](ShallowWrapper/setProps.md)\nManually sets props of the root component.\n\n#### [`.setContext(context) => ShallowWrapper`](ShallowWrapper/setContext.md)\nManually sets context of the root component.\n\n#### [`.getWrappingComponent() => ShallowWrapper`](ShallowWrapper/getWrappingComponent.md)\nReturns a wrapper representing the `wrappingComponent`, if one was passed.\n\n#### [`.instance() => ReactComponent`](ShallowWrapper/instance.md)\nReturns the instance of the root component.\n\n#### [`.update() => ShallowWrapper`](ShallowWrapper/update.md)\nSyncs the enzyme component tree snapshot with the react component tree.\n\n#### [`.debug() => String`](ShallowWrapper/debug.md)\nReturns a string representation of the current shallow render tree for debugging purposes.\n\n#### [`.type() => String|Function|null`](ShallowWrapper/type.md)\nReturns the type of the current node of the wrapper.\n\n#### [`.name() => String`](ShallowWrapper/name.md)\nReturns the name of the current node of the wrapper.\n\n#### [`.forEach(fn) => ShallowWrapper`](ShallowWrapper/forEach.md)\nIterates through each node of the current wrapper and executes the provided function\n\n#### [`.map(fn) => Array`](ShallowWrapper/map.md)\nMaps the current array of nodes to another array.\n\n#### [`.reduce(fn[, initialValue]) => Any`](ShallowWrapper/reduce.md)\nReduces the current array of nodes to a value\n\n#### [`.reduceRight(fn[, initialValue]) => Any`](ShallowWrapper/reduceRight.md)\nReduces the current array of nodes to a value, from right to left.\n\n#### [`.slice([begin[, end]]) => ShallowWrapper`](ShallowWrapper/slice.md)\nReturns a new wrapper with a subset of the nodes of the original wrapper, according to the rules of `Array#slice`.\n\n#### [`.tap(intercepter) => Self`](ShallowWrapper/tap.md)\nTaps into the wrapper method chain. Helpful for debugging.\n\n#### [`.some(selector) => Boolean`](ShallowWrapper/some.md)\nReturns whether or not any of the nodes in the wrapper match the provided selector.\n\n#### [`.someWhere(predicate) => Boolean`](ShallowWrapper/someWhere.md)\nReturns whether or not any of the nodes in the wrapper pass the provided predicate function.\n\n#### [`.every(selector) => Boolean`](ShallowWrapper/every.md)\nReturns whether or not all of the nodes in the wrapper match the provided selector.\n\n#### [`.everyWhere(predicate) => Boolean`](ShallowWrapper/everyWhere.md)\nReturns whether or not all of the nodes in the wrapper pass the provided predicate function.\n\n#### [`.dive([options]) => ShallowWrapper`](ShallowWrapper/dive.md)\nShallow render the one non-DOM child of the current wrapper, and return a wrapper around the result.\n" }, { "path": "docs/common-issues.md", "content": "# Common Issues\n\nThis list aims to be comprehensive. If you find an issue that has been frequently brought up in GitHub *Issues* that is not here, please open a PR to add it.\n\n### Query Selector fails\n\n###### Reason\n\nThis could be due to a regression, or the feature is not yet implemented. If you are wanting to use a\ncertain query syntax, make sure it is implemented first before raising an issue. Here is the list of\nselectors we currently support: https://github.com/enzymejs/enzyme/blob/master/docs/api/selector.md\n\n### Nested component may not be updated after wrapper updates\n\nAssume we have a simple component with an `` and a `\n \n
\n );\n }\n}\n```\n\nThis is a basic \"counter\" component in React. Here our resulting markup is a function of\n`this.state.count`, which can get updated by the `increment` and `decrement` functions. Let's take a\nlook at what some enzyme tests with this component might look like, and when we do or don't have to\ncall `update()`.\n\n```js\nconst wrapper = shallow();\nwrapper.find('.count').text(); // => \"Count: 0\"\n```\n\nAs we can see, we can easily assert on the text and the count of this component. But we haven't\ncaused any state changes yet. Let's see what it looks like when we simulate a `click` event on\nthe increment and decrement buttons:\n\n```js\nconst wrapper = shallow();\nwrapper.find('.count').text(); // => \"Count: 0\"\nwrapper.find('.inc').simulate('click');\nwrapper.find('.count').text(); // => \"Count: 1\"\nwrapper.find('.inc').simulate('click');\nwrapper.find('.count').text(); // => \"Count: 2\"\nwrapper.find('.dec').simulate('click');\nwrapper.find('.count').text(); // => \"Count: 1\"\n```\n\nIn this case enzyme will automatically check for updates after an event simulation takes place, as\nit knows that this is a very common place for state changes to occur. In this case there is no\ndifference between v2 and v3.\n\nLet's consider a different way this test could have been written.\n\n```js\nconst wrapper = shallow();\nwrapper.find('.count').text(); // => \"Count: 0\"\nwrapper.instance().increment();\nwrapper.find('.count').text(); // => \"Count: 0\" (would have been \"Count: 1\" in v2)\nwrapper.instance().increment();\nwrapper.find('.count').text(); // => \"Count: 0\" (would have been \"Count: 2\" in v2)\nwrapper.instance().decrement();\nwrapper.find('.count').text(); // => \"Count: 0\" (would have been \"Count: 1\" in v2)\n```\n\nThe problem here is that once we grab the instance using `wrapper.instance()`, enzyme has no way of\nknowing if you are going to execute something that will cause a state transition, and thus does not\nknow when to ask for an updated render tree from React. As a result, `.text()` never changes value.\n\nThe fix here is to use enzyme's `wrapper.update()` method after a state change has occurred:\n\n```js\nconst wrapper = shallow();\nwrapper.find('.count').text(); // => \"Count: 0\"\nwrapper.instance().increment();\nwrapper.update();\nwrapper.find('.count').text(); // => \"Count: 1\"\nwrapper.instance().increment();\nwrapper.update();\nwrapper.find('.count').text(); // => \"Count: 2\"\nwrapper.instance().decrement();\nwrapper.update();\nwrapper.find('.count').text(); // => \"Count: 1\"\n```\n\nIn practice we have found that this isn't actually needed that often, and when it is it is not\ndifficult to add. Additionally, having the enzyme wrapper automatically update alongside the real\nrender tree can result in flaky tests when writing asynchronous tests. This breaking change was\nworth the architectural benefits of the new adapter system in v3, and we believe is a better choice\nfor an assertion library to take.\n\n\n## `ref(refName)` now returns the actual ref instead of a wrapper\n\nIn enzyme v2, the wrapper returned from `mount(...)` had a prototype method on it `ref(refName)`\nthat returned a wrapper around the actual element of that ref. This has now been changed to\nreturn the actual ref, which we believe is a more intuitive API.\n\nConsider the following simple react component:\n\n\n```js\nclass Box extends React.Component {\n render() {\n return
Hello
;\n }\n}\n```\n\nIn this case we can call `.ref('abc')` on a wrapper of `Box`. In this case it will return a wrapper\naround the rendered div. To demonstrate, we can see that both `wrapper` and the result of `ref(...)`\nshare the same constructor:\n\n```js\nconst wrapper = mount();\n// this is what would happen with enzyme v2\nexpect(wrapper.ref('abc')).toBeInstanceOf(wrapper.constructor);\n```\n\nIn v3, the contract is slightly changed. The ref is exactly what React would assign as the ref. In\nthis case, it would be a DOM Element:\n\n```js\nconst wrapper = mount();\n// this is what happens with enzyme v3\nexpect(wrapper.ref('abc')).toBeInstanceOf(Element);\n```\n\nSimilarly, if you have a ref on a composite component, the `ref(...)` method will return an instance\nof that element:\n\n\n```js\nclass Bar extends React.Component {\n render() {\n return ;\n }\n}\n```\n\n```js\nconst wrapper = mount();\nexpect(wrapper.ref('abc')).toBeInstanceOf(Box);\n```\n\nIn our experience, this is most often what people would actually want and expect out of the `.ref(...)`\nmethod.\n\nTo get the wrapper that was returned by enzyme 2:\n```js\nconst wrapper = mount();\nconst refWrapper = wrapper.findWhere((n) => n.instance() === wrapper.ref('abc'));\n```\n\n## With `mount`, `.instance()` can be called at any level of the tree\n\nenzyme now allows for you to grab the `instance()` of a wrapper at any level of the render tree,\nnot just at the root. This means that you can `.find(...)` a specific component, then grab its\ninstance and call `.setState(...)` or any other methods on the instance that you'd like.\n\n\n## With `mount`, `.getNode()` should not be used. `.instance()` does what it used to.\n\nFor `mount` wrappers, the `.getNode()` method used to return the actual component instance. This\nmethod no longer exists, but `.instance()` is functionally equivalent to what `.getNode()` used to\nbe.\n\n\n## With `shallow`, `.getNode()` should be replaced with `getElement()`\n\nFor shallow wrappers, if you were previously using `.getNode()`, you will want to replace those\ncalls with `.getElement()`, which is now functionally equivalent to what `.getNode()` used to do.\nOne caveat is that previously `.getNode()` would return the actual element instance that was\ncreated in the `render` function of the component you were testing, but now it will be a\nstructurally equal react element, but not referentially equal. Your tests will need to be updated to\naccount for this.\n\n## Private properties and methods have been removed\n\nThere are several properties that are on an enzyme \"wrapper\" that were considered to be private and\nwere undocumented as a result. Despite being undocumented, people may have been relying on them. In\nan effort to make making changes less likely to be accidentally breaking in the future, we have\ndecided to make these properties properly \"private\". The following properties will no longer be\naccessible on enzyme `shallow` or `mount` instances:\n\n- `.node`\n- `.nodes`\n- `.renderer`\n- `.unrendered`\n- `.root`\n- `.options`\n\n\n## Cheerio has been updated, thus `render(...)` has been updated as well\n\nenzyme's top level `render` API returns a [Cheerio](https://github.com/cheeriojs/cheerio) object.\nThe version of Cheerio that we use has been upgraded to 1.0.0. For debugging issues across enzyme\nv2.x and v3.x with the `render` API, we recommend checking out [Cheerio's Changelog](https://github.com/cheeriojs/cheerio/blob/48eae25c93702a29b8cd0d09c4a2dce2f912d1f4/History.md) and\nposting an issue on that repo instead of enzyme's unless you believe it is a bug in enzyme's use\nof the library.\n\n## CSS Selector\n\nenzyme v3 now uses a real CSS selector parser rather than its own incomplete parser implementation.\nThis is done with [rst-selector-parser](https://github.com/aweary/rst-selector-parser) a fork of [scalpel](https://github.com/gajus/scalpel/) which is a CSS parser implemented with [nearley](https://nearley.js.org/).\nWe don't think this should cause any breakages across enzyme v2.x to v3.x, but if you believe you\nhave found something that did indeed break, please file an issue with us. Thank you to\n[Brandon Dail](https://github.com/aweary) for making this happen!\n\n## CSS Selector results and `hostNodes()`\n\nenzyme v3 now returns **all** nodes in the result set and not just html nodes.\nConsider this example:\n\n\n\n```js\nfunction HelpLink({ text, ...rest }) {\n return {text};\n}\n\nfunction HelpLinkContainer({ text, ...rest }) {\n return ;\n}\n\nconst wrapper = mount();\n```\n\nIn enzyme v3, the expression `wrapper.find(\"[aria-expanded=true]\").length)` will\nreturn 3 and not 1 as in previous versions. A closer look using\n[`debug`](../api/ReactWrapper/debug.md) reveals:\n\n\n\n```jsx\n// console.log(wrapper.find('[aria-expanded=\"true\"]').debug());\n\n\n \n \n foo\n \n \n\n\n\n \n foo\n \n\n\n\n foo\n\n```\n\nTo return only the html nodes use the\n[`hostNodes()`](../api/ReactWrapper/hostNodes.md) function.\n\n`wrapper.find(\"[aria-expanded=true]\").hostNodes().debug()` will now return:\n\n\n\n```jsx\nfoo;\n```\n\n## Node Equality now ignores `undefined` values\n\nWe have updated enzyme to consider node \"equality\" in a semantically identical way to how react\ntreats nodes. More specifically, we've updated enzyme's algorithms to treat `undefined` props as\nequivalent to the absence of a prop. Consider the following example:\n\n\n```js\nclass Foo extends React.Component {\n render() {\n const { foo, bar } = this.props;\n return
;\n }\n}\n```\n\nWith this component, the behavior in enzyme v2.x the behavior would have been like:\n\n```js\nconst wrapper = shallow();\nwrapper.equals(
); // => false\nwrapper.equals(
); // => true\n```\n\nWith enzyme v3, the behavior is now as follows:\n```js\nconst wrapper = shallow();\nwrapper.equals(
); // => true\nwrapper.equals(
); // => true\n```\n\n## Lifecycle methods\n\nenzyme v2.x had an optional flag that could be passed in to all `shallow` calls which would make it\nso that more of the component's lifecycle methods were called (such as `componentDidMount` and\n`componentDidUpdate`).\n\nWith enzyme v3, we have now turned on this mode by default, instead of making it opt-in. It is now\npossible to *opt-out* instead. Additionally, you can now opt-out at a global level.\n\nIf you'd like to opt out globally, you can run the following:\n\n```js\nimport Enzyme from 'enzyme';\n\nEnzyme.configure({ disableLifecycleMethods: true });\n```\n\nThis will default enzyme back to the previous behavior globally. If instead you'd only like to opt\nenzyme to the previous behavior for a specific test, you can do the following:\n\n```js\nimport { shallow } from 'enzyme';\n\n// ...\n\nconst wrapper = shallow(, { disableLifecycleMethods: true });\n```\n" }, { "path": "docs/guides/mocha.md", "content": "# Using enzyme with Mocha\n\nenzyme was originally designed to work with Mocha, so getting it up and running with Mocha should\nbe no problem at all. Simply install it and start using it:\n\n```bash\nnpm i --save-dev enzyme\n```\n\n```jsx\nimport React from 'react';\nimport { expect } from 'chai';\nimport { mount } from 'enzyme';\nimport { spy } from 'sinon';\nimport Foo from './src/Foo';\n\nspy(Foo.prototype, 'componentDidMount');\n\ndescribe('', () => {\n it('calls componentDidMount', () => {\n const wrapper = mount();\n expect(Foo.prototype.componentDidMount).to.have.property('callCount', 1);\n });\n});\n```" }, { "path": "docs/guides/react-native.md", "content": "# Using enzyme to Test Components in React Native\n\nAs of v0.18, React Native uses React as a dependency rather than a forked version of the library,\nwhich means it is now possible to use enzyme's `shallow` with React Native components.\n\nUnfortunately, React Native has many environmental dependencies that can be hard to simulate without\na host device.\n\nThis can be difficult when you want your test suite to run with typical Continuous Integration servers\nsuch as Travis.\n\nTo use enzyme to test React Native, you currently need to configure an adapter, and load an emulated DOM.\n\n## Configuring an Adapter\n\nWhile a React Native adapter is [in discussion](https://github.com/enzymejs/enzyme/issues/1436),\na standard adapter may be used, such as 'enzyme-adapter-react-16':\n\n```jsx\nimport Adapter from 'enzyme-adapter-react-16';\n\nEnzyme.configure({ adapter: new Adapter() });\n```\n\n## Loading an emulated DOM with JSDOM\n\nTo use enzyme's `mount` until a React Native adapter exists, an emulated DOM must be loaded.\n\nWhile some have had success with [react-native-mock-renderer](https://github.com/Root-App/react-native-mock-render),\nthe recommended approach is to use [JSDOM](https://github.com/jsdom/jsdom),\nas documented for enzyme at the [JSDOM](https://enzymejs.github.io/enzyme/docs/guides/jsdom.html) documentation page.\n\nJSDOM will allow all of the `enzyme` behavior you would expect. While Jest snapshot testing can be used with\nthis approach as well, it isn't encouraged and is only supported through `wrapper.debug()`.\n\n## Using enzyme's find when lacking className props\n\nIt is worth noting that React Native allows for a [testID](https://facebook.github.io/react-native/docs/view#testid)\nprop, that can be used a selector similar to `className` in standard React:\n\n\n```jsx\n \n {todo.title}\n \n```\n\n```jsx\nexpect(wrapper.findWhere((node) => node.prop('testID') === 'todo-item')).toExist();\n```\n\n## Default example configuration for Jest and JSDOM replacement\n\nTo perform the necessary configuration in your testing framework, it is recommended to use a setup script,\nsuch as with Jest's `setupFilesAfterEnv` setting.\n\nCreate or update a `jest.config.js` file at the root of your project to include the `setupFilesAfterEnv` setting:\n\n```jsx\n// jest.config.js\n\nmodule.exports = {\n // Load setup-tests.js before test execution\n setupFilesAfterEnv: 'setup-tests.js',\n\n // ...\n};\n```\n\nThen create or update the file specified in `setupFilesAfterEnv`, in this case `setup-tests.js` in the project root:\n\n```jsx\n// setup-tests.js\n\nimport 'react-native';\nimport 'jest-enzyme';\nimport Adapter from 'enzyme-adapter-react-16';\nimport Enzyme from 'enzyme';\n\n/**\n * Set up DOM in node.js environment for Enzyme to mount to\n */\nconst { JSDOM } = require('jsdom');\n\nconst jsdom = new JSDOM('');\nconst { window } = jsdom;\n\nfunction copyProps(src, target) {\n Object.defineProperties(target, {\n ...Object.getOwnPropertyDescriptors(src),\n ...Object.getOwnPropertyDescriptors(target),\n });\n}\n\nglobal.window = window;\nglobal.document = window.document;\nglobal.navigator = {\n userAgent: 'node.js',\n};\ncopyProps(window, global);\n\n/**\n * Set up Enzyme to mount to DOM, simulate events,\n * and inspect the DOM in tests.\n */\nEnzyme.configure({ adapter: new Adapter() });\n```\n\n## Configure enzyme with other test libraries and include JSDOM on the fly\n\nUpdate the file specified in `setupFilesAfterEnv`, in this case `setup-tests.js` in the project root:\n\n```jsx\nimport 'react-native';\nimport 'jest-enzyme';\nimport Adapter from 'enzyme-adapter-react-16';\nimport Enzyme from 'enzyme';\n\n/**\n * Set up Enzyme to mount to DOM, simulate events,\n * and inspect the DOM in tests.\n */\nEnzyme.configure({ adapter: new Adapter() });\n```\n\n### Create a separate test file\n\nCreate a file prefixed with enzyme.test.ts for example `component.enzyme.test.js`:\n\n```jsx\n/**\n * @jest-environment jsdom\n */\nimport React from 'react';\nimport { mount } from 'enzyme';\nimport { Text } from '../../../component/text';\n\ndescribe('Component tested with enzyme', () => {\n test('App mount with enzyme', () => {\n const wrapper = mount();\n // other tests operations\n });\n});\n```\n\n**The most important part is to ensure that the test runs with the `jestEnvironment` set to `jsdom`** - one way is to include a `/* @jest-environment jsdom */` comment at the top of the file.\n\n\n\nThen you should then be able to start writing tests!\n\nNote that you may want to perform some additional mocking around native components,\nor if you want to perform snapshot testing against React Native components. Notice\nhow you may need to mock React Navigation's `KeyGenerator` in this case, to avoid\nrandom React keys that will cause snapshots to always fail.\n\n```jsx\nimport React from 'react';\nimport renderer from 'react-test-renderer';\nimport { mount, ReactWrapper } from 'enzyme';\nimport { Provider } from 'mobx-react';\nimport { Text } from 'native-base';\n\nimport { TodoItem } from './todo-item';\nimport { TodoList } from './todo-list';\nimport { todoStore } from '../../stores/todo-store';\n\n// https://github.com/react-navigation/react-navigation/issues/2269\n// React Navigation generates random React keys, which makes\n// snapshot testing fail. Mock the randomness to keep from failing.\njest.mock('react-navigation/src/routers/KeyGenerator', () => ({\n generateKey: jest.fn(() => 123),\n}));\n\ndescribe('todo-list', () => {\n describe('enzyme tests', () => {\n it('can add a Todo with Enzyme', () => {\n const wrapper = mount(\n \n \n ,\n );\n\n const newTodoText = 'I need to do something...';\n const newTodoTextInput = wrapper.find('Input').first();\n const addTodoButton = wrapper\n .find('Button')\n .findWhere((w) => w.text() === 'Add Todo')\n .first();\n\n newTodoTextInput.props().onChangeText(newTodoText);\n\n // Enzyme usually allows wrapper.simulate() alternatively, but this doesn't support 'press' events.\n addTodoButton.props().onPress();\n\n // Make sure to call update if external events (e.g. Mobx state changes)\n // result in updating the component props.\n wrapper.update();\n\n // You can either check for a testID prop, similar to className in React:\n expect(\n wrapper.findWhere((node) => node.prop('testID') === 'todo-item'),\n ).toExist();\n\n // Or even just find a component itself, if you broke the JSX out into its own component:\n expect(wrapper.find(TodoItem)).toExist();\n\n // You can even do snapshot testing,\n // if you pull in enzyme-to-json and configure\n // it in snapshotSerializers in package.json\n expect(wrapper.find(TodoList)).toMatchSnapshot();\n });\n });\n});\n```\n" }, { "path": "docs/guides/systemjs.md", "content": "# Using enzyme with SystemJS\n\nIf you are using a test runner that runs code in a browser-based environment,\nyou may be using [SystemJS]() in order to bundle your React code.\n\nPrior to enzyme 3.0 there were some issues with conditional requires that were used\nto maintain backwards compatibility with React versions. With enzyme 3.0+, this\nshould no longer be an issue. If it is, please file a GitHub issue or make a PR\nto this documentation with instructions on how to set it up.\n" }, { "path": "docs/guides/tape-ava.md", "content": "# Using enzyme with Tape and AVA\n\nenzyme works well with [Tape](https://github.com/substack/tape) and [AVA](https://github.com/avajs/ava).\nSimply install it and start using it:\n\n```bash\nnpm i --save-dev enzyme enzyme-adapter-react-16\n```\n\n## Tape\n\n```jsx\nimport test from 'tape';\nimport React from 'react';\nimport { shallow, mount, configure } from 'enzyme';\nimport Adapter from 'enzyme-adapter-react-16';\n\nimport Foo from '../path/to/foo';\n\nconfigure({ adapter: new Adapter() });\n\ntest('shallow', (t) => {\n const wrapper = shallow();\n t.equal(wrapper.contains(Foo), true);\n});\n\ntest('mount', (t) => {\n const wrapper = mount();\n const fooInner = wrapper.find('.foo-inner');\n t.equal(fooInner.is('.foo-inner'), true);\n});\n```\n\n## AVA\n\n\n```jsx\nimport test from 'ava';\nimport React from 'react';\nimport { shallow, mount, configure } from 'enzyme';\nimport Adapter from 'enzyme-adapter-react-16';\n\nimport Foo from '../path/to/foo';\n\nconfigure({ adapter: new Adapter() });\n\ntest('shallow', (t) => {\n const wrapper = shallow();\n t.is(wrapper.contains(Foo), true);\n});\n\ntest('mount', (t) => {\n const wrapper = mount();\n const fooInner = wrapper.find('.foo-inner');\n t.is(fooInner.is('.foo-inner'), true);\n});\n```\n\n## Example Projects\n\n- [enzyme-example-tape](https://github.com/TaeKimJR/enzyme-example-tape)\n- [enzyme-example-ava](https://github.com/mikenikles/enzyme-example-ava)\n" }, { "path": "docs/guides/webpack.md", "content": "# Using enzyme with Webpack\n\nIf you are using a test runner that runs code in a browser-based environment, you may be using\n[webpack](https://webpack.js.org/) in order to bundle your React code.\n\nPrior to enzyme 3.0 there were some issues with conditional requires that were used\nto maintain backwards compatibility with React versions. With enzyme 3.0+, this\nshould no longer be an issue. If it is, please file a GitHub issue or make a PR\nto this documentation with instructions on how to set it up.\n" }, { "path": "docs/guides.md", "content": "# enzyme Guides\n\n- [*Using enzyme with Browserify*](guides/browserify.md)\n- [*Using enzyme with Webpack*](guides/webpack.md)\n- [*Using enzyme with JSDOM*](guides/jsdom.md)\n- [*Using enzyme with Jest*](guides/jest.md)\n- [*Using enzyme with Karma*](guides/karma.md)\n- [*Using enzyme with Mocha*](guides/mocha.md)\n- [*Using enzyme with React Native*](guides/react-native.md)\n- [*Using enzyme with Lab*](guides/lab.md)\n- [*Using enzyme with Tape and AVA*](guides/tape-ava.md)\n" }, { "path": "docs/installation/README.md", "content": "# Installation\n\nenzyme should be installed using npm:\n\n```bash\nnpm i --save-dev enzyme\n```\n\nenzyme can be used with your test runner of choice. All examples in the documentation will be\nprovided using [mocha](https://mochajs.org/) and [BDD style chai](http://chaijs.com/api/bdd/),\nalthough neither library is a dependency of enzyme.\n\n{% include \"./react-16.md\" %}\n\n{% include \"./react-15.md\" %}\n\n{% include \"./react-014.md\" %}\n\n{% include \"./react-013.md\" %}\n" }, { "path": "docs/installation/react-013.md", "content": "# Working with React 0.13\n\nIf you are wanting to use enzyme with React 0.13, but don't already have React 0.13 installed, you\nshould do so:\n\n```bash\nnpm i react@0.13 --save\n```\n\nNext, to get started with enzyme, you can simply install it with npm:\n\n```bash\nnpm i --save-dev enzyme enzyme-adapter-react-13\n```\n\nAnd then you're ready to go! In your test files you can simply `require` or `import` enzyme:\n\nES6:\n```js\n// setup file\nimport { configure } from 'enzyme';\nimport Adapter from 'enzyme-adapter-react-13';\n\nconfigure({ adapter: new Adapter() });\n```\n\n```js\n// test file\nimport { shallow, mount, render } from 'enzyme';\n\nconst wrapper = shallow();\n```\n\nES5:\n\n```js\n// setup file\nvar enzyme = require('enzyme');\nvar Adapter = require('enzyme-adapter-react-13');\n\nenzyme.configure({ adapter: new Adapter() });\n```\n\n\n```js\n// test file\nvar enzyme = require('enzyme');\n\nvar wrapper = enzyme.shallow();\n```\n" }, { "path": "docs/installation/react-014.md", "content": "# Working with React 0.14\n\nIf you are wanting to use Enzyme with React 0.14, but don't already have React 0.14 and react-dom\ninstalled, you should do so:\n\n```bash\nnpm i --save react@0.14 react-dom@0.14\n```\n\nFurther, enzyme with React 0.14 requires the test utilities addon be installed:\n\n```bash\nnpm i --save-dev react-addons-test-utils@0.14\n```\n\nNext, to get started with enzyme, you can simply install it with npm:\n\n```bash\nnpm i --save-dev enzyme enzyme-adapter-react-14\n```\n\nAnd then you're ready to go! In your test files you can simply `require` or `import` enzyme:\n\nES6:\n```js\n// setup file\nimport { configure } from 'enzyme';\nimport Adapter from 'enzyme-adapter-react-14';\n\nconfigure({ adapter: new Adapter() });\n```\n\n```js\n// test file\nimport { shallow, mount, render } from 'enzyme';\n\nconst wrapper = shallow();\n```\n\nES5:\n\n```js\n// setup file\nvar enzyme = require('enzyme');\nvar Adapter = require('enzyme-adapter-react-14');\n\nenzyme.configure({ adapter: new Adapter() });\n```\n\n\n```js\n// test file\nvar enzyme = require('enzyme');\n\nvar wrapper = enzyme.shallow();\n```\n" }, { "path": "docs/installation/react-15.md", "content": "# Working with React 15\n\nIf you are wanting to use Enzyme with React 15, but don't already have React 15 and react-dom\ninstalled, you should do so:\n\n```bash\nnpm i --save react@15 react-dom@15\n```\n\nFurther, enzyme requires the test utilities addon be installed:\n\n```bash\nnpm i --save-dev react-test-renderer@15\n```\n\nNext, to get started with enzyme, you can simply install it with npm:\n\n```bash\nnpm i --save-dev enzyme enzyme-adapter-react-15\n```\n\nAnd then you're ready to go! In your test files you can simply `require` or `import` enzyme:\n\nES6:\n```js\n// setup file\nimport { configure } from 'enzyme';\nimport Adapter from 'enzyme-adapter-react-15';\n\nconfigure({ adapter: new Adapter() });\n```\n\n```js\n// test file\nimport { shallow, mount, render } from 'enzyme';\n\nconst wrapper = shallow();\n```\n\nES5:\n\n```js\n// setup file\nvar enzyme = require('enzyme');\nvar Adapter = require('enzyme-adapter-react-15');\n\nenzyme.configure({ adapter: new Adapter() });\n```\n\n\n```js\n// test file\nvar enzyme = require('enzyme');\n\nvar wrapper = enzyme.shallow();\n```\n" }, { "path": "docs/installation/react-16.md", "content": "# Working with React 16\n\nIf you are wanting to use enzyme with React 16, but don't already have React 16 and react-dom\ninstalled, you should do so:\n\n```bash\nnpm i --save react@16 react-dom@16\n```\n\nNext, to get started with enzyme, you can simply install it with npm:\n\n```bash\nnpm i --save-dev enzyme enzyme-adapter-react-16\n```\n\nAnd then you're ready to go! In your test files you can simply `require` or `import` enzyme:\n\nES6:\n```js\n// setup file\nimport { configure } from 'enzyme';\nimport Adapter from 'enzyme-adapter-react-16';\n\nconfigure({ adapter: new Adapter() });\n```\n\n```js\n// test file\nimport { shallow, mount, render } from 'enzyme';\n\nconst wrapper = shallow();\n```\n\nES5:\n\n```js\n// setup file\nvar enzyme = require('enzyme');\nvar Adapter = require('enzyme-adapter-react-16');\n\nenzyme.configure({ adapter: new Adapter() });\n```\n\n\n```js\n// test file\nvar enzyme = require('enzyme');\n\nvar wrapper = enzyme.shallow();\n```\n" }, { "path": "env.js", "content": "'use strict';\n\nconst path = require('path');\nconst fs = require('fs');\nconst spawn = require('child_process').spawn;\nconst rimraf = require('rimraf');\nconst semver = require('semver');\n\nconst promisify = (fn) => new Promise((res, rej) => {\n const done = (err, val) => (err ? rej(err) : res(val));\n fn(done);\n});\nconst getFile = (fpath) => promisify((cb) => fs.readFile(fpath, 'utf8', cb));\n// const getFiles = fpath => promisify(cb => fs.readdir(fpath, cb));\nconst getJSON = (fpath) => getFile(fpath).then((json) => JSON.parse(json));\nconst writeFile = (fpath, src) => promisify((cb) => {\n console.log('writeFile', fpath, src);\n if (process.env.DEBUG) {\n cb();\n } else {\n fs.writeFile(fpath, src, cb);\n }\n});\nconst writeJSON = (fpath, json, pretty = false) => writeFile(\n fpath,\n (pretty ? JSON.stringify(json, null, 2) : JSON.stringify(json)) + '\\n'\n);\nconst primraf = (fpath) => promisify((cb) => {\n console.log('rimraf', fpath);\n if (process.env.DEBUG) {\n cb();\n } else {\n rimraf(fpath, cb);\n }\n});\nconst run = (cmd, ...args) => promisify((cb) => {\n console.log(cmd + ' ' + args.join(' '));\n const child = spawn(\n process.env.DEBUG ? 'echo' : cmd,\n process.env.DEBUG ? [cmd].concat(args) : args,\n { stdio: 'inherit' }\n );\n child.on('exit', cb);\n});\n\n// This script is executed with a single argument, indicating the version of\n// react and adapters etc. that we want to set ourselves up for testing.\n// should be \"14\" for \"enzyme-adapter-react-14\", \"15.4\" for \"enzyme-adapter-react-15.4\", etc.\nconst version = process.argv[2];\n\n// This script will do the following:\n//\n// 1. remove / uninstall all relevant modules\n// 2. find the adapter for the passed in version\n// 3. get the package.json for the adapter\n// 4. add the adapter to the dev-deps for enzyme-test-suite package\n// 5. call lerna bootstrap to link all the packages\n// 6. install all of the package's peer deps at the top level\n\nconst root = process.cwd();\n\nfunction getAdapter(reactVersion) {\n if (semver.intersects(reactVersion, '0.13.x')) {\n return '13';\n }\n if (semver.intersects(reactVersion, '0.14.x')) {\n return '14';\n }\n if (semver.intersects(reactVersion, '^15.0.0-0')) {\n if (semver.intersects(reactVersion, '>= 15.5')) {\n return '15';\n }\n return '15.4';\n }\n if (semver.intersects(reactVersion, '^16.0.0-0')) {\n if (semver.intersects(reactVersion, '>= 16.4')) {\n return '16';\n }\n if (semver.intersects(reactVersion, '~16.3')) {\n return '16.3';\n }\n if (semver.intersects(reactVersion, '~16.2')) {\n return '16.2';\n }\n if (semver.intersects(reactVersion, '~16.0 || ~16.1')) {\n return '16.1';\n }\n }\n return null;\n}\nconst reactVersion = version < 15 ? '0.' + version : version;\nconst adapterVersion = process.env.ADAPTER || getAdapter(reactVersion) || version;\nconst adapterName = `enzyme-adapter-react-${adapterVersion}`;\nconst adapterPackageJsonPath = path.join(root, 'packages', adapterName, 'package.json');\nconst testPackageJsonPath = path.join(root, 'packages', 'enzyme-test-suite', 'package.json');\n\nif (!fs.statSync(adapterPackageJsonPath)) {\n throw new Error('Adapter not found: \"' + adapterName + '\"');\n}\n\nconst packagesToRemove = [\n 'react',\n 'react-dom',\n 'react-addons-test-utils',\n 'react-test-renderer',\n 'create-react-class',\n].map((s) => `./node_modules/${s}`);\n\nconst additionalDirsToRemove = [\n];\n\nconst rmrfs = []\n .concat(packagesToRemove)\n .concat(additionalDirsToRemove);\n\nPromise.resolve()\n .then(() => Promise.all(rmrfs.map((s) => primraf(s))))\n .then(() => run('npm', 'i'))\n .then(() => Promise.all([\n getJSON(adapterPackageJsonPath),\n getJSON(testPackageJsonPath),\n ]))\n .then(([adapterJson, testJson]) => {\n const peerDeps = adapterJson.peerDependencies;\n const installs = Object.keys(peerDeps)\n .filter((key) => !key.startsWith('enzyme'))\n .map((key) => `${key}@${key.startsWith('react') ? reactVersion : peerDeps[key]}`);\n\n if (process.env.RENDERER) {\n // eslint-disable-next-line no-param-reassign\n adapterJson.dependencies['react-test-renderer'] = process.env.RENDERER;\n }\n\n // eslint-disable-next-line no-param-reassign\n testJson.dependencies[adapterName] = adapterJson.version;\n\n return writeJSON(adapterPackageJsonPath, adapterJson, true).then(() => Promise.all([\n // npm install the peer deps at the root\n run('npm', 'i', '--no-save', ...installs),\n\n // add the adapter to the dependencies of the test suite\n writeJSON(testPackageJsonPath, testJson, true),\n ]));\n })\n .then(() => run('lerna', 'bootstrap', '--hoist=\\'react*\\''))\n .then(() => getJSON(testPackageJsonPath))\n .then((testJson) => {\n // now that we've lerna bootstrapped, we can remove the adapter from the\n // package.json so there is no diff\n // eslint-disable-next-line no-param-reassign\n delete testJson.dependencies[adapterName];\n return writeJSON(testPackageJsonPath, testJson, true);\n })\n .catch((err) => console.error(err));\n" }, { "path": "install-relevant-react.sh", "content": "#!/bin/sh\n\nREACT=\"${REACT:-${1:-16}}\"\n\necho \"installing React $REACT\"\n\nif [ \"$REACT\" = \"0.13\" ]; then\n npm run env: -- 13\nelif [ \"$REACT\" = \"0.14\" ]; then\n npm run env: -- 14\nelse\n npm run env: -- \"${REACT}\"\nfi\n" }, { "path": "karma.conf.js", "content": "/* eslint-disable no-var,prefer-arrow-callback,vars-on-top, import/no-extraneous-dependencies */\n\n'use strict';\n\nrequire('@babel/register');\n\nvar IgnorePlugin = require('webpack').IgnorePlugin;\nvar is = require('./packages/enzyme-test-suite/build/_helpers/version').is;\n\nfunction getPlugins() {\n const adapter13 = new IgnorePlugin(/enzyme-adapter-react-13$/);\n const adapter14 = new IgnorePlugin(/enzyme-adapter-react-14$/);\n const adapter154 = new IgnorePlugin(/enzyme-adapter-react-15\\.4$/);\n const adapter15 = new IgnorePlugin(/enzyme-adapter-react-15$/);\n const adapter161 = new IgnorePlugin(/enzyme-adapter-react-16.1$/);\n const adapter162 = new IgnorePlugin(/enzyme-adapter-react-16.2$/);\n const adapter163 = new IgnorePlugin(/enzyme-adapter-react-16.3$/);\n const adapter16 = new IgnorePlugin(/enzyme-adapter-react-16$/);\n\n var plugins = [\n adapter13,\n adapter14,\n adapter154,\n adapter15,\n adapter16,\n ];\n\n function not(x) {\n return function notPredicate(y) {\n return y !== x;\n };\n }\n\n // we want to ignore all of the adapters *except* the one we are currently using\n if (is('0.13.x')) {\n plugins = plugins.filter(not(adapter13));\n } else if (is('0.14.x')) {\n plugins = plugins.filter(not(adapter14));\n } else if (is('^15.5.0')) {\n plugins = plugins.filter(not(adapter15));\n } else if (is('^15.0.0-0')) {\n plugins = plugins.filter(not(adapter154));\n } else if (is('~16.0.0-0 || ~16.1')) {\n plugins = plugins.filter(not(adapter161));\n } else if (is('~16.2')) {\n plugins = plugins.filter(not(adapter162));\n } else if (is('~16.3.0-0')) {\n plugins = plugins.filter(not(adapter163));\n } else if (is('^16.4.0-0')) {\n plugins = plugins.filter(not(adapter16));\n }\n\n return plugins;\n}\n\nmodule.exports = function karma(config) {\n config.set({\n basePath: '.',\n\n plugins: [\n 'karma-chrome-launcher',\n 'karma-firefox-launcher',\n 'karma-mocha',\n 'karma-webpack',\n 'karma-sourcemap-loader',\n ],\n\n customLaunchers: {\n Chrome_travis: {\n base: 'Chrome',\n flags: ['--no-sandbox'],\n },\n },\n\n frameworks: ['mocha'],\n\n reporters: ['dots'],\n\n files: [\n 'packages/enzyme-test-suite/build/*.js',\n ],\n\n exclude: [\n 'packages/enzyme-test-suite/build/_helpers/index.js',\n ],\n\n browsers: [\n process.env.TRAVIS ? 'Chrome_travis' : 'Chrome',\n 'Firefox',\n ],\n\n preprocessors: {\n 'packages/enzyme-test-suite/build/*.js': ['webpack', 'sourcemap'],\n },\n\n webpack: {\n devtool: 'inline-source-map',\n resolve: {\n extensions: ['', '.js', '.jsx', '.json'],\n alias: {\n // dynamic require calls in sinon confuse webpack so we ignore it\n sinon: 'sinon/pkg/sinon',\n },\n },\n module: {\n noParse: [\n // dynamic require calls in sinon confuse webpack so we ignore it\n /node_modules\\/sinon\\//,\n ],\n loaders: [\n {\n test: /\\.jsx?$/,\n exclude: /node_modules/,\n loader: 'babel-loader',\n },\n {\n test: /\\.json$/,\n loader: 'json-loader',\n },\n ],\n },\n plugins: getPlugins(),\n },\n\n webpackServer: {\n noInfo: true,\n },\n });\n};\n" }, { "path": "lerna.json", "content": "{\n \"lerna\": \"2.0.0\",\n \"packages\": [\n \"packages/*\"\n ],\n \"version\": \"independent\",\n \"independent\": true\n}\n" }, { "path": "package.json", "content": "{\n \"name\": \"enzyme\",\n \"private\": true,\n \"version\": \"0.0.1\",\n \"description\": \"JavaScript Testing utilities for React\",\n \"homepage\": \"https://enzymejs.github.io/enzyme/\",\n \"scripts\": {\n \"clean-node-modules\": \"rm -rf node_modules/{*,.bin,.package-lock.json} && rm -rf packages/*/node_modules/{*,.bin,.package-lock.json}\",\n \"postinstall\": \"[ -n \\\"${TRAVIS-}\\\" ] || (npm link npm && lerna bootstrap)\",\n \"preversion\": \"npm run clean && npm run check\",\n \"postversion\": \"git push && git push --tags && npm run clean && npm run docs:publish\",\n \"version\": \"lerna run build\",\n \"clean\": \"lerna run clean\",\n \"prelint\": \"npm run lint:root\",\n \"lint\": \"lerna exec --parallel 'npm run lint -- --quiet'\",\n \"lint:root\": \"eslint . --ext=js,md,jsx --ignore-pattern=packages/\",\n \"check\": \"lerna run lint && npm run test:all\",\n \"prebuild\": \"npm run clean\",\n \"build\": \"lerna run build\",\n \"build:watch\": \"lerna run --parallel watch\",\n \"pretest\": \"lerna run lint\",\n \"test\": \"npm run test:only\",\n \"pretest:only\": \"npm run build\",\n \"test:only\": \"mocha --recursive packages/enzyme-test-suite/build\",\n \"test:single\": \"mocha --watch\",\n \"test:watch\": \"npm run test:only -- --watch\",\n \"pretest:karma\": \"npm run build\",\n \"test:karma\": \"karma start\",\n \"test:all\": \"npm run react 13 && npm run test:only && npm run react 14 && npm run test:only && npm run react 15 && npm run test:only && npm run react 15.4 && npm run test:only && npm run react 15.5 && npm run test:only && npm run react 16 && npm run test:only && npm run react 16.1 && npm run test:only && npm run react 16.2 && npm run test:only && npm run react 16.3 && npm run test:only && npm run react 16.4 && npm run test:only && npm run react 16.5 && npm run test:only && npm run react 16.8 && npm run test:only\",\n \"react\": \"sh install-relevant-react.sh\",\n \"env:\": \"babel-node ./env.js\",\n \"docs:clean\": \"rimraf _book\",\n \"docs:prepare\": \"gitbook install\",\n \"docs:build\": \"npm run docs:prepare && gitbook build\",\n \"docs:watch\": \"npm run docs:prepare && gitbook serve\",\n \"docs:publish\": \"npm run docs:clean && npm run docs:build && cd _book && git init && git commit --allow-empty -m 'update book' && git fetch git@github.com:enzymejs/enzyme.git gh-pages && git checkout -b gh-pages && git add . && git commit -am 'update book' && git push git@github.com:enzymejs/enzyme.git gh-pages --force\",\n \"travis\": \"nyc mocha --recursive packages/enzyme-test-suite/build\",\n \"since\": \"node since\"\n },\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/enzymejs/enzyme.git\"\n },\n \"keywords\": [\n \"javascript\",\n \"shallow rendering\",\n \"shallowRender\",\n \"test\",\n \"reactjs\",\n \"react\",\n \"flux\",\n \"testing\",\n \"test utils\",\n \"assertion helpers\",\n \"tdd\",\n \"mocha\"\n ],\n \"author\": \"Jordan Harband \",\n \"license\": \"MIT\",\n \"devDependencies\": {\n \"@babel/cli\": \"^7.28.3\",\n \"@babel/core\": \"^7.28.4\",\n \"@babel/eslint-parser\": \"^7.28.4\",\n \"@babel/node\": \"~7.24.8\",\n \"@babel/register\": \"^7.28.3\",\n \"@babel/runtime\": \"^7.28.4\",\n \"babel-loader\": \"^8.2.2\",\n \"babel-plugin-add-module-exports\": \"^1.0.4\",\n \"babel-plugin-transform-replace-object-assign\": \"^2.0.0\",\n \"babel-preset-airbnb\": \"^4.5.0\",\n \"chai\": \"^4.3.4\",\n \"eslint\": \"^8.56.0\",\n \"eslint-config-airbnb\": \"^19.0.4\",\n \"eslint-plugin-import\": \"^2.32.0\",\n \"eslint-plugin-jsx-a11y\": \"^6.10.2\",\n \"eslint-plugin-markdown\": \"^3.0.1\",\n \"eslint-plugin-react\": \"^7.37.5\",\n \"eslint-plugin-react-hooks\": \"^4.6.0\",\n \"gitbook-cli\": \"^1.0.1\",\n \"gitbook-plugin-anchors\": \"^0.7.1\",\n \"gitbook-plugin-codeblock-disable-glossary\": \"0.0.1\",\n \"gitbook-plugin-collapsible-menu\": \"^1.0.3\",\n \"gitbook-plugin-edit-link\": \"^2.0.2\",\n \"gitbook-plugin-github\": \"^2.0.0\",\n \"glob-gitignore\": \"^1.0.14\",\n \"in-publish\": \"^2.0.1\",\n \"json-loader\": \"^0.5.7\",\n \"karma\": \"^1.3.0\",\n \"karma-chrome-launcher\": \"^1.0.1\",\n \"karma-firefox-launcher\": \"^1.3.0\",\n \"karma-mocha\": \"^1.3.0\",\n \"karma-sourcemap-loader\": \"^0.3.7\",\n \"karma-webpack\": \"^1.8.1\",\n \"lerna\": \"^2.11.0\",\n \"mocha\": \"^3.5.3\",\n \"mocha-lcov-reporter\": \"^1.3.0\",\n \"npm\": \"gist:9cdb687f3806f8e6cb8a365d0b7840eb\",\n \"nyc\": \"^10.3.2\",\n \"prop-types\": \"^15.8.1\",\n \"rimraf\": \"^2.7.1\",\n \"safe-publish-latest\": \"^2.0.0\",\n \"semver\": \"^6.3.1\",\n \"webpack\": \"^2.7.0\"\n },\n \"greenkeeper\": {\n \"ignore\": [\n \"mocha\",\n \"nyc\",\n \"semver\",\n \"webpack\"\n ]\n }\n}\n" }, { "path": "packages/enzyme/.babelrc", "content": "{\n \"presets\": [\n [\"airbnb\", { \"transformRuntime\": false }],\n ],\n \"plugins\": [\n [\"transform-replace-object-assign\", { \"moduleSpecifier\": \"object.assign\" }],\n [\"add-module-exports\"],\n ],\n \"sourceMaps\": \"both\",\n}\n" }, { "path": "packages/enzyme/.eslintrc", "content": "{\n \"extends\": \"airbnb\",\n \"parser\": \"@babel/eslint-parser\",\n \"root\": true,\n \"ignorePatterns\": [\"build/\"],\n \"env\": {\n \"node\": true,\n \"mocha\": true\n },\n \"rules\": {\n \"id-length\": 0,\n \"max-classes-per-file\": 0,\n \"new-cap\": [2, { \"capIsNewExceptions\": [\"AND\"] }],\n \"react/jsx-pascal-case\": [2, { \"allowAllCaps\": true }],\n \"react/no-find-dom-node\": 1,\n \"import/first\": 0,\n \"no-underscore-dangle\": [2, {\n \"allowAfterThis\": true,\n \"allow\": [\n \"_context\",\n \"_currentElement\",\n \"_instance\",\n \"_reactInternalComponent\",\n \"_reactInternalInstance\",\n \"_renderedChildren\",\n \"_renderedComponent\",\n \"_renderedNodeType\",\n \"_state\",\n \"_store\",\n \"_stringText\",\n ],\n }],\n }\n}\n" }, { "path": "packages/enzyme/ReactWrapper.js", "content": "module.exports = require('./build/ReactWrapper');\n" }, { "path": "packages/enzyme/ShallowWrapper.js", "content": "module.exports = require('./build/ShallowWrapper');\n" }, { "path": "packages/enzyme/mount.js", "content": "module.exports = require('./build/mount');\n" }, { "path": "packages/enzyme/package.json", "content": "{\n \"name\": \"enzyme\",\n \"version\": \"3.11.0\",\n \"description\": \"JavaScript Testing utilities for React\",\n \"homepage\": \"https://enzymejs.github.io/enzyme/\",\n \"main\": \"build\",\n \"scripts\": {\n \"prepack\": \"npmignore --auto --commentLines=autogenerated --gitignore=../../.gitignore && cp ../../{LICENSE,README}.md ./ && npm run build\",\n \"prepublishOnly\": \"safe-publish-latest\",\n \"prepublish\": \"not-in-publish || npm run prepublishOnly\",\n \"clean\": \"rimraf build\",\n \"lint\": \"eslint --ext js,jsx .\",\n \"pretest\": \"npm run lint\",\n \"prebuild\": \"npm run clean\",\n \"build\": \"babel --source-maps=both src --out-dir build\",\n \"watch\": \"npm run build -- -w\"\n },\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/enzymejs/enzyme.git\",\n \"directory\": \"packages/enzyme\"\n },\n \"keywords\": [\n \"javascript\",\n \"shallow rendering\",\n \"shallowRender\",\n \"test\",\n \"reactjs\",\n \"react\",\n \"flux\",\n \"testing\",\n \"test utils\",\n \"assertion helpers\",\n \"tdd\",\n \"mocha\"\n ],\n \"author\": \"Jordan Harband \",\n \"funding\": {\n \"url\": \"https://github.com/sponsors/ljharb\"\n },\n \"license\": \"MIT\",\n \"dependencies\": {\n \"array.prototype.flat\": \"^1.3.3\",\n \"cheerio\": \"=1.0.0-rc.3\",\n \"enzyme-shallow-equal\": \"^1.0.7\",\n \"function.prototype.name\": \"^1.1.8\",\n \"hasown\": \"^2.0.2\",\n \"html-element-map\": \"^1.3.1\",\n \"is-boolean-object\": \"^1.2.2\",\n \"is-callable\": \"^1.2.7\",\n \"is-number-object\": \"^1.1.1\",\n \"is-regex\": \"^1.2.1\",\n \"is-string\": \"^1.1.1\",\n \"is-subset\": \"^0.1.1\",\n \"lodash.escape\": \"^4.0.1\",\n \"lodash.isequal\": \"^4.5.0\",\n \"object-inspect\": \"^1.13.4\",\n \"object-is\": \"^1.1.6\",\n \"object.assign\": \"^4.1.7\",\n \"object.entries\": \"^1.1.9\",\n \"object.fromentries\": \"^2.0.8\",\n \"object.values\": \"^1.2.1\",\n \"raf\": \"^3.4.1\",\n \"rst-selector-parser\": \"^2.2.3\",\n \"string.prototype.trim\": \"^1.2.10\"\n },\n \"devDependencies\": {\n \"@babel/cli\": \"^7.28.3\",\n \"@babel/core\": \"^7.28.4\",\n \"@babel/eslint-parser\": \"^7.28.4\",\n \"babel-plugin-add-module-exports\": \"^1.0.4\",\n \"babel-plugin-transform-replace-object-assign\": \"^2.0.0\",\n \"babel-preset-airbnb\": \"^4.5.0\",\n \"eslint\": \"^8.56.0\",\n \"eslint-config-airbnb\": \"^19.0.4\",\n \"eslint-plugin-import\": \"^2.32.0\",\n \"eslint-plugin-jsx-a11y\": \"^6.10.2\",\n \"eslint-plugin-react\": \"^7.37.5\",\n \"eslint-plugin-react-hooks\": \"^4.6.0\",\n \"in-publish\": \"^2.0.1\",\n \"jsdom\": \"^6.5.1\",\n \"npmignore\": \"^0.3.1\",\n \"rimraf\": \"^2.7.1\",\n \"safe-publish-latest\": \"^2.0.0\"\n },\n \"publishConfig\": {\n \"ignore\": [\n \"!build\"\n ]\n }\n}\n" }, { "path": "packages/enzyme/render.js", "content": "module.exports = require('./build/render');\n" }, { "path": "packages/enzyme/shallow.js", "content": "module.exports = require('./build/shallow');\n" }, { "path": "packages/enzyme/src/Debug.js", "content": "import escape from 'lodash.escape';\nimport functionName from 'function.prototype.name';\nimport isString from 'is-string';\nimport isNumber from 'is-number-object';\nimport isCallable from 'is-callable';\nimport isBoolean from 'is-boolean-object';\nimport inspect from 'object-inspect';\nimport hasOwn from 'hasown';\n\nimport {\n propsOfNode,\n childrenOfNode,\n} from './RSTTraversal';\nimport getAdapter from './getAdapter';\n\nconst booleanValue = Function.bind.call(Function.call, Boolean.prototype.valueOf);\n\nexport function typeName(node) {\n const adapter = getAdapter();\n if (adapter.displayNameOfNode) {\n return getAdapter().displayNameOfNode(node) || 'Component';\n }\n return typeof node.type === 'function'\n ? (node.type.displayName || functionName(node.type) || 'Component')\n : node.type;\n}\n\nexport function spaces(n) {\n return Array(n + 1).join(' ');\n}\n\nexport function indent(depth, string) {\n return string.split('\\n').map((x) => `${spaces(depth)}${x}`).join('\\n');\n}\n\nfunction propString(prop, options) {\n if (isString(prop)) {\n return inspect(String(prop), { quoteStyle: 'double' });\n }\n if (isNumber(prop)) {\n return `{${inspect(Number(prop))}}`;\n }\n if (isBoolean(prop)) {\n return `{${inspect(booleanValue(prop))}}`;\n }\n if (isCallable(prop)) {\n return `{${inspect(prop)}}`;\n }\n if (typeof prop === 'object') {\n if (options.verbose) {\n return `{${inspect(prop)}}`;\n }\n\n return '{{...}}';\n }\n return `{[${inspect(prop)}]}`;\n}\n\nfunction propsString(node, options) {\n const props = propsOfNode(node);\n const keys = Object.keys(props).filter((x) => x !== 'children');\n return keys.map((key) => `${key}=${propString(props[key], options)}`).join(' ');\n}\n\nfunction indentChildren(childrenStrs, indentLength) {\n return childrenStrs.length\n ? `\\n${childrenStrs.map((x) => indent(indentLength, x)).join('\\n')}\\n`\n : '';\n}\n\nfunction isRSTNodeLike(node) {\n return hasOwn(node, 'nodeType')\n && typeof node.nodeType === 'string'\n && hasOwn(node, 'type')\n && hasOwn(node, 'key')\n && hasOwn(node, 'ref')\n && hasOwn(node, 'instance')\n && hasOwn(node, 'rendered');\n}\n\nexport function debugNode(node, indentLength = 2, options = {}) {\n if (typeof node === 'string' || typeof node === 'number') return escape(node);\n if (typeof node === 'function') {\n const name = functionName(node);\n return `[function${name ? ` ${name}` : ''}]`;\n }\n if (!node) return '';\n\n const adapter = getAdapter();\n if (!adapter.isValidElement(node) && !isRSTNodeLike(node)) {\n return `{${inspect(node)}}`;\n }\n\n const childrenStrs = childrenOfNode(node)\n .map((n) => debugNode(n, indentLength, options))\n .filter(Boolean);\n const type = typeName(node);\n\n const props = options.ignoreProps ? '' : propsString(node, options);\n const beforeProps = props ? ' ' : '';\n const afterProps = childrenStrs.length\n ? '>'\n : ' ';\n const childrenIndented = indentChildren(childrenStrs, indentLength);\n const nodeClose = childrenStrs.length ? `` : '/>';\n return `<${type}${beforeProps}${props}${afterProps}${childrenIndented}${nodeClose}`;\n}\n\nexport function debugNodes(nodes, options = {}) {\n return nodes.map((node) => debugNode(node, undefined, options)).join('\\n\\n\\n');\n}\n" }, { "path": "packages/enzyme/src/EnzymeAdapter.js", "content": "function unimplementedError(methodName, classname) {\n return new Error(`${methodName} is a required method of ${classname}, but was not implemented.`);\n}\n\nclass EnzymeAdapter {\n constructor() {\n this.options = {};\n }\n\n // Provided a bag of options, return an `EnzymeRenderer`. Some options can be implementation\n // specific, like `attach` etc. for React, but not part of this interface explicitly.\n // eslint-disable-next-line class-methods-use-this, no-unused-vars\n createRenderer(options) {\n throw unimplementedError('createRenderer', 'EnzymeAdapter');\n }\n\n // converts an RSTNode to the corresponding JSX Pragma Element. This will be needed\n // in order to implement the `Wrapper.mount()` and `Wrapper.shallow()` methods, but should\n // be pretty straightforward for people to implement.\n // eslint-disable-next-line class-methods-use-this, no-unused-vars\n nodeToElement(node) {\n throw unimplementedError('nodeToElement', 'EnzymeAdapter');\n }\n\n // eslint-disable-next-line class-methods-use-this\n matchesElementType(node, matchingType) {\n if (!node) {\n return node;\n }\n const { type } = node;\n return type === matchingType;\n }\n\n // eslint-disable-next-line class-methods-use-this, no-unused-vars\n isValidElement(element) {\n throw unimplementedError('isValidElement', 'EnzymeAdapter');\n }\n\n // eslint-disable-next-line class-methods-use-this, no-unused-vars\n createElement(type, props, ...children) {\n throw unimplementedError('createElement', 'EnzymeAdapter');\n }\n\n // eslint-disable-next-line class-methods-use-this\n invokeSetStateCallback(instance, callback) {\n callback.call(instance);\n }\n}\n\nEnzymeAdapter.MODES = {\n STRING: 'string',\n MOUNT: 'mount',\n SHALLOW: 'shallow',\n};\n\nexport default EnzymeAdapter;\n" }, { "path": "packages/enzyme/src/RSTTraversal.js", "content": "import flat from 'array.prototype.flat';\nimport entries from 'object.entries';\nimport fromEntries from 'object.fromentries';\nimport isSubset from 'is-subset';\nimport functionName from 'function.prototype.name';\nimport isRegex from 'is-regex';\nimport getAdapter from './getAdapter';\n\nexport function propsOfNode(node) {\n return (node && node.props) || {};\n}\n\nexport function childrenOfNode(node) {\n if (!node) return [];\n\n const adapter = getAdapter();\n const adapterHasIsFragment = adapter.isFragment && typeof adapter.isFragment === 'function';\n\n const renderedArray = Array.isArray(node.rendered) ? flat(node.rendered, 1) : [node.rendered];\n\n // React adapters before 16 will not have isFragment\n if (!adapterHasIsFragment) {\n return renderedArray;\n }\n\n return flat(renderedArray.map((currentChild) => {\n // If the node is a Fragment, we want to return its children, not the fragment itself\n if (adapter.isFragment(currentChild)) {\n return childrenOfNode(currentChild);\n }\n\n return currentChild;\n }), 1);\n}\n\nexport function hasClassName(node, className) {\n let classes = propsOfNode(node).className || '';\n classes = String(classes).replace(/\\s/g, ' ');\n if (isRegex(className)) return className.test(classes);\n return ` ${classes} `.indexOf(` ${className} `) > -1;\n}\n\nexport function treeForEach(tree, fn) {\n if (tree) {\n fn(tree);\n }\n childrenOfNode(tree).forEach((node) => treeForEach(node, fn));\n}\n\nexport function treeFilter(tree, fn) {\n const results = [];\n treeForEach(tree, (node) => {\n if (fn(node)) {\n results.push(node);\n }\n });\n return results;\n}\n\n/**\n * To support sibling selectors we need to be able to find\n * the siblings of a node. The easiest way to do that is find\n * the parent of the node and access its children.\n *\n * This would be unneeded if the RST spec included sibling pointers\n * such as node.nextSibling and node.prevSibling\n * @param {*} root\n * @param {*} targetNode\n */\nexport function findParentNode(root, targetNode) {\n const results = treeFilter(\n root,\n (node) => {\n if (!node.rendered) {\n return false;\n }\n\n return childrenOfNode(node).indexOf(targetNode) !== -1;\n },\n );\n return results[0] || null;\n}\n\nfunction pathFilter(path, fn) {\n return path.filter((tree) => treeFilter(tree, fn).length !== 0);\n}\n\nexport function pathToNode(node, root) {\n const queue = [root];\n const path = [];\n\n const hasNode = (testNode) => node === testNode;\n\n while (queue.length) {\n const current = queue.pop();\n const children = childrenOfNode(current);\n if (current === node) return pathFilter(path, hasNode);\n\n path.push(current);\n\n if (children.length === 0) {\n // leaf node. if it isn't the node we are looking for, we pop.\n path.pop();\n }\n queue.push(...children);\n }\n\n return null;\n}\n\nexport function parentsOfNode(node, root) {\n return (pathToNode(node, root) || []).reverse();\n}\n\nexport function nodeHasId(node, id) {\n return propsOfNode(node).id === id;\n}\n\nconst CAN_NEVER_MATCH = {};\nfunction replaceUndefined(v) {\n return typeof v !== 'undefined' ? v : CAN_NEVER_MATCH;\n}\nfunction replaceUndefinedValues(obj) {\n const newEntries = entries(obj).map(([k, v]) => [k, replaceUndefined(v)]);\n return fromEntries(newEntries);\n}\n\nexport function nodeMatchesObjectProps(node, props) {\n return isSubset(propsOfNode(node), replaceUndefinedValues(props));\n}\n\nfunction getTextFromHostNode(hostNode) {\n if (typeof hostNode === 'string') {\n return String(hostNode || '');\n }\n if (!hostNode) {\n return '';\n }\n return hostNode.textContent || '';\n}\n\nfunction getTextFromRSTNode(node, {\n getCustom,\n handleHostNodes,\n recurse,\n nullRenderReturnsNull = false,\n}) {\n if (node == null) {\n return '';\n }\n\n if (typeof node === 'string' || typeof node === 'number') {\n return String(node);\n }\n\n if (getCustom && node.type && typeof node.type === 'function') {\n return getCustom(node);\n }\n\n if (handleHostNodes && node.nodeType === 'host') {\n return handleHostNodes(node);\n }\n if (node.rendered == null && nullRenderReturnsNull) {\n return null;\n }\n return childrenOfNode(node).map(recurse).join('');\n}\n\nexport function getTextFromNode(node) {\n return getTextFromRSTNode(node, {\n recurse: getTextFromNode,\n getCustom({ type }) {\n return `<${type.displayName || functionName(type)} />`;\n },\n });\n}\n\nexport function getTextFromHostNodes(node, adapter) {\n return getTextFromRSTNode(node, {\n recurse(item) {\n return getTextFromHostNodes(item, adapter);\n },\n handleHostNodes(item) {\n const nodes = [].concat(adapter.nodeToHostNode(item, true));\n return nodes.map(getTextFromHostNode).join('');\n },\n });\n}\n\nfunction getHTMLFromHostNode(hostNode) {\n if (hostNode == null) {\n return null;\n }\n return hostNode.outerHTML.replace(/\\sdata-(reactid|reactroot)+=\"([^\"]*)+\"/g, '');\n}\n\nexport function getHTMLFromHostNodes(node, adapter) {\n return getTextFromRSTNode(node, {\n recurse(item) {\n return getHTMLFromHostNodes(item, adapter);\n },\n handleHostNodes(item) {\n const nodes = [].concat(adapter.nodeToHostNode(item, true));\n return nodes.map(getHTMLFromHostNode).join('');\n },\n nullRenderReturnsNull: true,\n });\n}\n" }, { "path": "packages/enzyme/src/ReactWrapper.js", "content": "import flat from 'array.prototype.flat';\nimport hasOwn from 'hasown';\nimport trim from 'string.prototype.trim';\n\nimport {\n containsChildrenSubArray,\n typeOfNode,\n displayNameOfNode,\n ITERATOR_SYMBOL,\n nodeEqual,\n nodeMatches,\n makeOptions,\n sym,\n privateSet,\n cloneElement,\n renderedDive,\n isCustomComponent,\n loadCheerioRoot,\n} from './Utils';\nimport getAdapter from './getAdapter';\nimport { debugNodes } from './Debug';\nimport {\n propsOfNode,\n hasClassName,\n childrenOfNode,\n parentsOfNode,\n treeFilter,\n getTextFromHostNodes,\n getHTMLFromHostNodes,\n} from './RSTTraversal';\n\nimport { buildPredicate, reduceTreesBySelector } from './selectors';\n\nconst NODE = sym('__node__');\nconst NODES = sym('__nodes__');\nconst RENDERER = sym('__renderer__');\nconst UNRENDERED = sym('__unrendered__');\nconst ROOT = sym('__root__');\nconst OPTIONS = sym('__options__');\nconst ROOT_NODES = sym('__rootNodes__');\nconst WRAPPING_COMPONENT = sym('__wrappingComponent__');\nconst LINKED_ROOTS = sym('__linkedRoots__');\nconst UPDATED_BY = sym('__updatedBy__');\n\n/**\n * Finds all nodes in the current wrapper nodes' render trees that match the provided predicate\n * function.\n *\n * @param {ReactWrapper} wrapper\n * @param {Function} predicate\n * @param {Function} filter\n * @returns {ReactWrapper}\n */\nfunction findWhereUnwrapped(wrapper, predicate, filter = treeFilter) {\n return wrapper.flatMap((n) => filter(n.getNodeInternal(), predicate));\n}\n\n/**\n * Returns a new wrapper instance with only the nodes of the current wrapper instance that match\n * the provided predicate function.\n *\n * @param {ReactWrapper} wrapper\n * @param {Function} predicate\n * @returns {ReactWrapper}\n */\nfunction filterWhereUnwrapped(wrapper, predicate) {\n return wrapper.wrap(wrapper.getNodesInternal().filter(predicate).filter(Boolean));\n}\n\nfunction getRootNodeInternal(wrapper) {\n if (wrapper[ROOT].length !== 1) {\n throw new Error('getRootNodeInternal(wrapper) can only be called when wrapper wraps one node');\n }\n if (wrapper[ROOT] !== wrapper) {\n return wrapper[ROOT_NODES][0];\n }\n return wrapper[ROOT][NODE];\n}\n\nfunction nodeParents(wrapper, node) {\n return parentsOfNode(node, getRootNodeInternal(wrapper));\n}\n\nfunction privateSetNodes(wrapper, nodes) {\n if (!nodes) {\n privateSet(wrapper, NODE, null);\n privateSet(wrapper, NODES, []);\n } else if (!Array.isArray(nodes)) {\n privateSet(wrapper, NODE, nodes);\n privateSet(wrapper, NODES, [nodes]);\n } else {\n privateSet(wrapper, NODE, nodes[0]);\n privateSet(wrapper, NODES, nodes);\n }\n privateSet(wrapper, 'length', wrapper[NODES].length);\n}\n\n/**\n * @class ReactWrapper\n */\nclass ReactWrapper {\n constructor(nodes, root, passedOptions = {}) {\n if (!global.window && !global.document) {\n throw new Error('It looks like you called `mount()` without a global document being loaded.');\n }\n const options = makeOptions(passedOptions);\n\n if (!root) {\n const adapter = getAdapter(options);\n if (!adapter.isValidElement(nodes)) {\n throw new TypeError('ReactWrapper can only wrap valid elements');\n }\n\n const renderer = adapter.createRenderer({ mode: 'mount', ...options });\n privateSet(this, RENDERER, renderer);\n renderer.render(nodes, options.context);\n privateSet(this, ROOT, this);\n privateSetNodes(this, this[RENDERER].getNode());\n privateSet(this, OPTIONS, options);\n privateSet(this, LINKED_ROOTS, []);\n\n if (isCustomComponent(options.wrappingComponent, adapter)) {\n if (typeof this[RENDERER].getWrappingComponentRenderer !== 'function') {\n throw new TypeError('your adapter does not support `wrappingComponent`. Try upgrading it!');\n }\n\n privateSet(\n this,\n WRAPPING_COMPONENT,\n // eslint-disable-next-line no-use-before-define\n new WrappingComponentWrapper(this, this[RENDERER].getWrappingComponentRenderer()),\n );\n this[LINKED_ROOTS].push(this[WRAPPING_COMPONENT]);\n }\n } else {\n privateSet(this, RENDERER, root[RENDERER]);\n privateSet(this, ROOT, root);\n privateSetNodes(this, nodes);\n privateSet(this, ROOT_NODES, root[NODES]);\n privateSet(this, OPTIONS, root[OPTIONS]);\n privateSet(this, LINKED_ROOTS, []);\n }\n privateSet(this, UNRENDERED, nodes);\n privateSet(this, UPDATED_BY, null);\n }\n\n /**\n * Returns the root wrapper\n *\n * @return {ReactWrapper}\n */\n root() {\n return this[ROOT];\n }\n\n /**\n * Returns the wrapped component.\n *\n * @return {ReactComponent}\n */\n getNodeInternal() {\n if (this.length !== 1) {\n throw new Error('ReactWrapper::getNode() can only be called when wrapping one node');\n }\n return this[NODES][0];\n }\n\n /**\n * Returns the the wrapped components.\n *\n * @return {Array}\n */\n getNodesInternal() {\n return this[NODES];\n }\n\n /**\n * Returns the wrapped ReactElement.\n *\n * @return {ReactElement}\n */\n getElement() {\n return this.single('getElement', () => getAdapter(this[OPTIONS]).nodeToElement(this[NODE]));\n }\n\n /**\n * Returns the wrapped ReactElements.\n *\n * @return {Array}\n */\n getElements() {\n return this[NODES].map((n) => getAdapter(this[OPTIONS]).nodeToElement(n));\n }\n\n // eslint-disable-next-line class-methods-use-this\n getNode() {\n throw new Error('ReactWrapper::getNode() is no longer supported. Use ReactWrapper::instance() instead');\n }\n\n // eslint-disable-next-line class-methods-use-this\n getNodes() {\n throw new Error('ReactWrapper::getNodes() is no longer supported.');\n }\n\n /**\n * Returns the outer most DOMComponent of the current wrapper.\n *\n * NOTE: can only be called on a wrapper of a single node.\n *\n * @returns {DOMComponent}\n */\n getDOMNode() {\n const adapter = getAdapter(this[OPTIONS]);\n return this.single('getDOMNode', (n) => adapter.nodeToHostNode(n, true));\n }\n\n /**\n * If the root component contained a ref, you can access it here and get the relevant\n * react component instance or HTML element instance.\n *\n * NOTE: can only be called on a wrapper instance that is also the root instance.\n *\n * @param {String} refname\n * @returns {ReactComponent | HTMLElement}\n */\n ref(refname) {\n if (this[ROOT] !== this) {\n throw new Error('ReactWrapper::ref(refname) can only be called on the root');\n }\n return this.instance().refs[refname];\n }\n\n /**\n * Returns the wrapper's underlying instance.\n *\n * Example:\n * ```\n * const wrapper = mount();\n * const inst = wrapper.instance();\n * expect(inst).to.be.instanceOf(MyComponent);\n * ```\n * @returns {ReactComponent|DOMComponent}\n */\n instance() {\n return this.single('instance', () => this[NODE].instance);\n }\n\n /**\n * If a `wrappingComponent` was passed in `options`, this methods returns a `ReactWrapper` around\n * the rendered `wrappingComponent`. This `ReactWrapper` can be used to update the\n * `wrappingComponent`'s props, state, etc.\n *\n * @returns ReactWrapper\n */\n getWrappingComponent() {\n if (this[ROOT] !== this) {\n throw new Error('ReactWrapper::getWrappingComponent() can only be called on the root');\n }\n if (!this[OPTIONS].wrappingComponent) {\n throw new Error('ReactWrapper::getWrappingComponent() can only be called on a wrapper that was originally passed a `wrappingComponent` option');\n }\n return this[WRAPPING_COMPONENT];\n }\n\n /**\n * Forces a re-render. Useful to run before checking the render output if something external\n * may be updating the state of the component somewhere.\n *\n * NOTE: no matter what instance this is called on, it will always update the root.\n *\n * @returns {ReactWrapper}\n */\n update() {\n const root = this[ROOT];\n if (this !== root) {\n return root.update();\n }\n privateSetNodes(this, this[RENDERER].getNode());\n this[LINKED_ROOTS].forEach((linkedRoot) => {\n if (linkedRoot !== this[UPDATED_BY]) {\n /* eslint-disable no-param-reassign */\n // Only update a linked it root if it is not the originator of our update().\n // This is needed to prevent infinite recursion when there is a bi-directional\n // link between two roots.\n linkedRoot[UPDATED_BY] = this;\n try {\n linkedRoot.update();\n } finally {\n linkedRoot[UPDATED_BY] = null;\n }\n }\n });\n return this;\n }\n\n /**\n * A method that unmounts the component. This can be used to simulate a component going through\n * and unmount/mount lifecycle.\n *\n * @returns {ReactWrapper}\n */\n unmount() {\n if (this[ROOT] !== this) {\n throw new Error('ReactWrapper::unmount() can only be called on the root');\n }\n this.single('unmount', () => {\n this[RENDERER].unmount();\n this.update();\n });\n return this;\n }\n\n /**\n * A method that re-mounts the component, if it is not currently mounted.\n * This can be used to simulate a component going through\n * an unmount/mount lifecycle.\n *\n * @returns {ReactWrapper}\n */\n mount() {\n if (this[ROOT] !== this) {\n throw new Error('ReactWrapper::mount() can only be called on the root');\n }\n this[RENDERER].render(this[UNRENDERED], this[OPTIONS].context, () => this.update());\n return this;\n }\n\n /**\n * A method that sets the props of the root component, and re-renders. Useful for when you are\n * wanting to test how the component behaves over time with changing props. Calling this, for\n * instance, will call the `componentWillReceiveProps` lifecycle method.\n *\n * Similar to `setState`, this method accepts a props object and will merge it in with the already\n * existing props.\n *\n * NOTE: can only be called on a wrapper instance that is also the root instance.\n *\n * @param {Object} props object\n * @param {Function} cb - callback function\n * @returns {ReactWrapper}\n */\n setProps(props, callback = undefined) {\n if (this[ROOT] !== this) {\n throw new Error('ReactWrapper::setProps() can only be called on the root');\n }\n if (arguments.length > 1 && typeof callback !== 'function') {\n throw new TypeError('ReactWrapper::setProps() expects a function as its second argument');\n }\n const adapter = getAdapter(this[OPTIONS]);\n this[UNRENDERED] = cloneElement(adapter, this[UNRENDERED], props);\n this[RENDERER].render(this[UNRENDERED], null, () => {\n this.update();\n if (callback) {\n callback();\n }\n });\n return this;\n }\n\n /**\n * A method to invoke `setState` on the root component instance similar to how you might in the\n * definition of the component, and re-renders. This method is useful for testing your component\n * in hard to achieve states, however should be used sparingly. If possible, you should utilize\n * your component's external API in order to get it into whatever state you want to test, in order\n * to be as accurate of a test as possible. This is not always practical, however.\n *\n * NOTE: can only be called on a wrapper instance that is also the root instance.\n *\n * @param {Object} state to merge\n * @param {Function} cb - callback function\n * @returns {ReactWrapper}\n */\n setState(state, callback = undefined) {\n if (this.instance() === null || this.getNodeInternal().nodeType !== 'class') {\n throw new Error('ReactWrapper::setState() can only be called on class components');\n }\n if (arguments.length > 1 && typeof callback !== 'function') {\n throw new TypeError('ReactWrapper::setState() expects a function as its second argument');\n }\n this.instance().setState(state, () => {\n this.update();\n if (callback) {\n const adapter = getAdapter(this[OPTIONS]);\n const instance = this.instance();\n if (adapter.invokeSetStateCallback) {\n adapter.invokeSetStateCallback(instance, callback);\n } else {\n callback.call(instance);\n }\n }\n });\n return this;\n }\n\n /**\n * A method that sets the context of the root component, and re-renders. Useful for when you are\n * wanting to test how the component behaves over time with changing contexts.\n *\n * NOTE: can only be called on a wrapper instance that is also the root instance.\n *\n * @param {Object} context object\n * @returns {ReactWrapper}\n */\n setContext(context) {\n if (this[ROOT] !== this) {\n throw new Error('ReactWrapper::setContext() can only be called on the root');\n }\n if (!this[OPTIONS].context) {\n throw new Error('ReactWrapper::setContext() can only be called on a wrapper that was originally passed a context option');\n }\n this[RENDERER].render(this[UNRENDERED], context, () => this.update());\n return this;\n }\n\n /**\n * Whether or not a given react element exists in the mount render tree.\n *\n * Example:\n * ```\n * const wrapper = mount();\n * expect(wrapper.contains(
)).to.equal(true);\n * ```\n *\n * @param {ReactElement|Array} nodeOrNodes\n * @returns {Boolean}\n */\n contains(nodeOrNodes) {\n const adapter = getAdapter(this[OPTIONS]);\n\n const predicate = Array.isArray(nodeOrNodes)\n ? (other) => containsChildrenSubArray(\n nodeEqual,\n other,\n nodeOrNodes.map((node) => adapter.elementToNode(node)),\n )\n : (other) => nodeEqual(adapter.elementToNode(nodeOrNodes), other);\n\n return findWhereUnwrapped(this, predicate).length > 0;\n }\n\n /**\n * Whether or not a given react element exists in the current render tree.\n * It will determine if one of the wrappers element \"looks like\" the expected\n * element by checking if all props of the expected element are present\n * on the wrappers element and equals to each other.\n *\n * Example:\n * ```\n * // MyComponent outputs
Hello
\n * const wrapper = mount();\n * expect(wrapper.containsMatchingElement(
Hello
)).to.equal(true);\n * ```\n *\n * @param {ReactElement} node\n * @returns {Boolean}\n */\n containsMatchingElement(node) {\n const rstNode = getAdapter(this[OPTIONS]).elementToNode(node);\n const predicate = (other) => nodeMatches(rstNode, other, (a, b) => a <= b);\n return findWhereUnwrapped(this, predicate).length > 0;\n }\n\n /**\n * Whether or not all the given react elements exist in the current render tree.\n * It will determine if one of the wrappers element \"looks like\" the expected\n * element by checking if all props of the expected element are present\n * on the wrappers element and equals to each other.\n *\n * Example:\n * ```\n * const wrapper = mount();\n * expect(wrapper.containsAllMatchingElements([\n *
Hello
,\n *
Goodbye
,\n * ])).to.equal(true);\n * ```\n *\n * @param {Array} nodes\n * @returns {Boolean}\n */\n containsAllMatchingElements(nodes) {\n if (!Array.isArray(nodes)) {\n throw new TypeError('nodes should be an Array');\n }\n\n return nodes.every((node) => this.containsMatchingElement(node));\n }\n\n /**\n * Whether or not one of the given react elements exists in the current render tree.\n * It will determine if one of the wrappers element \"looks like\" the expected\n * element by checking if all props of the expected element are present\n * on the wrappers element and equals to each other.\n *\n * Example:\n * ```\n * const wrapper = mount();\n * expect(wrapper.containsAnyMatchingElements([\n *
Hello
,\n *
Goodbye
,\n * ])).to.equal(true);\n * ```\n *\n * @param {Array} nodes\n * @returns {Boolean}\n */\n containsAnyMatchingElements(nodes) {\n return Array.isArray(nodes) && nodes.some((node) => this.containsMatchingElement(node));\n }\n\n /**\n * Whether or not a given react element exists in the render tree.\n *\n * Example:\n * ```\n * const wrapper = mount();\n * expect(wrapper.contains(
)).to.equal(true);\n * ```\n *\n * @param {ReactElement} node\n * @returns {Boolean}\n */\n equals(node) {\n return this.single('equals', () => nodeEqual(this.getNodeInternal(), node));\n }\n\n /**\n * Whether or not a given react element matches the render tree.\n * Match is based on the expected element and not on wrapper root node.\n * It will determine if the wrapper root node \"looks like\" the expected\n * element by checking if all props of the expected element are present\n * on the wrapper root node and equals to each other.\n *\n * Example:\n * ```\n * // MyComponent outputs
Hello
\n * const wrapper = mount();\n * expect(wrapper.matchesElement(
Hello
)).to.equal(true);\n * ```\n *\n * @param {ReactElement} node\n * @returns {Boolean}\n */\n matchesElement(node) {\n return this.single('matchesElement', () => {\n const adapter = getAdapter(this[OPTIONS]);\n const rstNode = adapter.elementToNode(node);\n return nodeMatches(rstNode, this.getNodeInternal(), (a, b) => a <= b);\n });\n }\n\n /**\n * Finds every node in the render tree of the current wrapper that matches the provided selector.\n *\n * @param {EnzymeSelector} selector\n * @returns {ReactWrapper}\n */\n find(selector) {\n return this.wrap(reduceTreesBySelector(selector, this.getNodesInternal()));\n }\n\n /**\n * Returns whether or not current node matches a provided selector.\n *\n * NOTE: can only be called on a wrapper of a single node.\n *\n * @param {EnzymeSelector} selector\n * @returns {boolean}\n */\n is(selector) {\n const predicate = buildPredicate(selector);\n return this.single('is', (n) => predicate(n));\n }\n\n /**\n * Returns true if the component rendered nothing, i.e., null or false.\n *\n * @returns {boolean}\n */\n isEmptyRender() {\n const nodes = this.getNodesInternal();\n\n return nodes.every((node) => renderedDive(node));\n }\n\n /**\n * Returns a new wrapper instance with only the nodes of the current wrapper instance that match\n * the provided predicate function.\n *\n * @param {Function} predicate\n * @returns {ReactWrapper}\n */\n filterWhere(predicate) {\n return filterWhereUnwrapped(this, (n) => predicate(this.wrap(n)));\n }\n\n /**\n * Returns a new wrapper instance with only the nodes of the current wrapper instance that match\n * the provided selector.\n *\n * @param {EnzymeSelector} selector\n * @returns {ReactWrapper}\n */\n filter(selector) {\n const predicate = buildPredicate(selector);\n return filterWhereUnwrapped(this, predicate);\n }\n\n /**\n * Returns a new wrapper instance with only the nodes of the current wrapper that did not match\n * the provided selector. Essentially the inverse of `filter`.\n *\n * @param {EnzymeSelector} selector\n * @returns {ReactWrapper}\n */\n not(selector) {\n const predicate = buildPredicate(selector);\n return filterWhereUnwrapped(this, (n) => !predicate(n));\n }\n\n /**\n * Returns a string of the rendered text of the current render tree. This function should be\n * looked at with skepticism if being used to test what the actual HTML output of the component\n * will be. If that is what you would like to test, use enzyme's `render` function instead.\n *\n * NOTE: can only be called on a wrapper of a single node.\n *\n * @returns {String}\n */\n text() {\n const adapter = getAdapter(this[OPTIONS]);\n return this.single('text', (n) => getTextFromHostNodes(n, adapter));\n }\n\n /**\n * Returns the HTML of the node.\n *\n * NOTE: can only be called on a wrapper of a single node.\n *\n * @returns {String}\n */\n html() {\n const adapter = getAdapter(this[OPTIONS]);\n return this.single('html', (n) => getHTMLFromHostNodes(n, adapter));\n }\n\n /**\n * Returns the current node rendered to HTML and wrapped in a CheerioWrapper.\n *\n * NOTE: can only be called on a wrapper of a single node.\n *\n * @returns {CheerioWrapper}\n */\n render() {\n const html = this.html();\n return loadCheerioRoot(html);\n }\n\n /**\n * Used to simulate events. Pass an eventname and (optionally) event arguments. This method of\n * testing events should be met with some skepticism.\n *\n * @param {String} event\n * @param {Object} mock (optional)\n * @returns {ReactWrapper}\n */\n simulate(event, mock = {}) {\n return this.single('simulate', (n) => {\n this[RENDERER].simulateEvent(n, event, mock);\n this[ROOT].update();\n return this;\n });\n }\n\n /**\n * Used to simulate throwing a rendering error. Pass an error to throw.\n *\n * @param {String} error\n * @returns {ReactWrapper}\n */\n simulateError(error) {\n if (this[ROOT] === this) {\n throw new Error('ReactWrapper::simulateError() may not be called on the root');\n }\n\n return this.single('simulateError', (thisNode) => {\n if (thisNode.nodeType === 'host') {\n throw new Error('ReactWrapper::simulateError() can only be called on custom components');\n }\n\n const renderer = this[RENDERER];\n if (typeof renderer.simulateError !== 'function') {\n throw new TypeError('your adapter does not support `simulateError`. Try upgrading it!');\n }\n\n const rootNode = getRootNodeInternal(this);\n const nodeHierarchy = [thisNode].concat(nodeParents(this, thisNode));\n renderer.simulateError(nodeHierarchy, rootNode, error);\n\n this[ROOT].update();\n return this;\n });\n }\n\n /**\n * Returns the props hash for the root node of the wrapper.\n *\n * NOTE: can only be called on a wrapper of a single node.\n *\n * @returns {Object}\n */\n props() {\n return this.single('props', propsOfNode);\n }\n\n /**\n * Returns the state hash for the root node of the wrapper. Optionally pass in a prop name and it\n * will return just that value.\n *\n * NOTE: can only be called on a wrapper of a single node.\n *\n * @param {String} name (optional)\n * @returns {*}\n */\n state(name) {\n const thisNode = this[ROOT] === this ? this[RENDERER].getNode() : this.getNodeInternal();\n if (this.instance() === null || thisNode.nodeType !== 'class') {\n throw new Error('ReactWrapper::state() can only be called on class components');\n }\n const _state = this.single('state', () => this.instance().state);\n if (typeof name !== 'undefined') {\n if (_state == null) {\n throw new TypeError(`ReactWrapper::state(\"${name}\") requires that \\`state\\` not be \\`null\\` or \\`undefined\\``);\n }\n return _state[name];\n }\n return _state;\n }\n\n /**\n * Returns the context hash for the root node of the wrapper.\n * Optionally pass in a prop name and it will return just that value.\n *\n * NOTE: can only be called on a wrapper of a single node.\n *\n * @param {String} name (optional)\n * @returns {*}\n */\n context(name) {\n if (this[ROOT] !== this) {\n throw new Error('ReactWrapper::context() can only be called on the root');\n }\n const instance = this.single('context', () => this.instance());\n if (instance === null) {\n throw new Error('ReactWrapper::context() can only be called on wrapped nodes that have a non-null instance');\n }\n const _context = instance.context;\n if (typeof name !== 'undefined') {\n return _context[name];\n }\n return _context;\n }\n\n /**\n * Returns a new wrapper with all of the children of the current wrapper.\n *\n * @param {EnzymeSelector} [selector]\n * @returns {ReactWrapper}\n */\n children(selector) {\n const allChildren = this.flatMap((n) => childrenOfNode(n.getNodeInternal()));\n return selector ? allChildren.filter(selector) : allChildren;\n }\n\n /**\n * Returns a new wrapper with a specific child\n *\n * @param {Number} [index]\n * @returns {ReactWrapper}\n */\n childAt(index) {\n return this.single('childAt', () => this.children().at(index));\n }\n\n /**\n * Returns a wrapper around all of the parents/ancestors of the wrapper. Does not include the node\n * in the current wrapper.\n *\n * NOTE: can only be called on a wrapper of a single node.\n *\n * @param {EnzymeSelector} [selector]\n * @returns {ReactWrapper}\n */\n parents(selector) {\n return this.single('parents', (n) => {\n const allParents = this.wrap(nodeParents(this, n));\n return selector ? allParents.filter(selector) : allParents;\n });\n }\n\n /**\n * Returns a wrapper around the immediate parent of the current node.\n *\n * @returns {ReactWrapper}\n */\n parent() {\n return this.flatMap((n) => [n.parents().get(0)]);\n }\n\n /**\n *\n * @param {EnzymeSelector} selector\n * @returns {ReactWrapper}\n */\n closest(selector) {\n if (this.is(selector)) {\n return this;\n }\n const matchingAncestors = this.parents().filter(selector);\n return matchingAncestors.length > 0 ? matchingAncestors.first() : this.findWhere(() => false);\n }\n\n /**\n * Returns the value of prop with the given name of the root node.\n *\n * @param {String} propName\n * @returns {*}\n */\n prop(propName) {\n return this.props()[propName];\n }\n\n /**\n * Used to invoke a function prop.\n * Will invoke an function prop and return its value.\n *\n * @param {String} propName\n * @returns {Any}\n */\n invoke(propName) {\n return this.single('invoke', () => {\n const handler = this.prop(propName);\n if (typeof handler !== 'function') {\n throw new TypeError('ReactWrapper::invoke() requires the name of a prop whose value is a function');\n }\n return (...args) => {\n const response = typeof this[RENDERER].wrapInvoke === 'function'\n ? this[RENDERER].wrapInvoke(() => handler(...args))\n : handler(...args);\n this[ROOT].update();\n return response;\n };\n });\n }\n\n /**\n * Returns a wrapper of the node rendered by the provided render prop.\n *\n * @param {String} propName\n * @returns {Function}\n */\n renderProp(propName) {\n const adapter = getAdapter(this[OPTIONS]);\n if (typeof adapter.wrap !== 'function') {\n throw new RangeError('your adapter does not support `wrap`. Try upgrading it!');\n }\n\n return this.single('renderProp', (n) => {\n if (n.nodeType === 'host') {\n throw new TypeError('ReactWrapper::renderProp() can only be called on custom components');\n }\n if (typeof propName !== 'string') {\n throw new TypeError('ReactWrapper::renderProp(): `propName` must be a string');\n }\n const props = this.props();\n if (!hasOwn(props, propName)) {\n throw new Error(`ReactWrapper::renderProp(): no prop called “${propName}“ found`);\n }\n const propValue = props[propName];\n if (typeof propValue !== 'function') {\n throw new TypeError(`ReactWrapper::renderProp(): expected prop “${propName}“ to contain a function, but it holds “${typeof propValue}“`);\n }\n\n return (...args) => {\n const element = propValue(...args);\n const wrapped = adapter.wrap(element);\n return this.wrap(wrapped, null, this[OPTIONS]);\n };\n });\n }\n\n /**\n * Returns the key assigned to the current node.\n *\n * @returns {String}\n */\n key() {\n return this.single('key', (n) => (n.key === undefined ? null : n.key));\n }\n\n /**\n * Returns the type of the root node of this wrapper. If it's a composite component, this will be\n * the component constructor. If it's native DOM node, it will be a string.\n *\n * @returns {String|Function}\n */\n type() {\n return this.single('type', (n) => typeOfNode(n));\n }\n\n /**\n * Returns the name of the root node of this wrapper.\n *\n * In order of precedence => type.displayName -> type.name -> type.\n *\n * @returns {String}\n */\n name() {\n const adapter = getAdapter(this[OPTIONS]);\n return this.single('name', (n) => (\n adapter.displayNameOfNode ? adapter.displayNameOfNode(n) : displayNameOfNode(n)\n ));\n }\n\n /**\n * Returns whether or not the current root node has the given class name or not.\n *\n * NOTE: can only be called on a wrapper of a single node.\n *\n * @param {String} className\n * @returns {Boolean}\n */\n hasClass(className) {\n if (typeof className === 'string' && className.indexOf('.') !== -1) {\n // eslint-disable-next-line no-console\n console.warn('It looks like you\\'re calling `ReactWrapper::hasClass()` with a CSS selector. hasClass() expects a class name, not a CSS selector.');\n }\n return this.single('hasClass', (n) => hasClassName(n, className));\n }\n\n /**\n * Iterates through each node of the current wrapper and executes the provided function with a\n * wrapper around the corresponding node passed in as the first argument.\n *\n * @param {Function} fn\n * @returns {ReactWrapper}\n */\n forEach(fn) {\n this.getNodesInternal().forEach((n, i) => fn.call(this, this.wrap(n), i));\n return this;\n }\n\n /**\n * Maps the current array of nodes to another array. Each node is passed in as a `ReactWrapper`\n * to the map function.\n *\n * @param {Function} fn\n * @returns {Array}\n */\n map(fn) {\n return this.getNodesInternal().map((n, i) => fn.call(this, this.wrap(n), i));\n }\n\n /**\n * Reduces the current array of nodes to another array.\n * Each node is passed in as a `ShallowWrapper` to the reducer function.\n *\n * @param {Function} fn - the reducer function\n * @param {*} initialValue - the initial value\n * @returns {*}\n */\n reduce(fn, initialValue = undefined) {\n if (arguments.length > 1) {\n return this.getNodesInternal().reduce(\n (accum, n, i) => fn.call(this, accum, this.wrap(n), i),\n initialValue,\n );\n }\n return this.getNodesInternal().reduce((accum, n, i) => fn.call(\n this,\n i === 1 ? this.wrap(accum) : accum,\n this.wrap(n),\n i,\n ));\n }\n\n /**\n * Reduces the current array of nodes to another array, from right to left. Each node is passed\n * in as a `ShallowWrapper` to the reducer function.\n *\n * @param {Function} fn - the reducer function\n * @param {*} initialValue - the initial value\n * @returns {*}\n */\n reduceRight(fn, initialValue = undefined) {\n if (arguments.length > 1) {\n return this.getNodesInternal().reduceRight(\n (accum, n, i) => fn.call(this, accum, this.wrap(n), i),\n initialValue,\n );\n }\n return this.getNodesInternal().reduceRight((accum, n, i) => fn.call(\n this,\n i === 1 ? this.wrap(accum) : accum,\n this.wrap(n),\n i,\n ));\n }\n\n /**\n * Returns a new wrapper with a subset of the nodes of the original wrapper, according to the\n * rules of `Array#slice`.\n *\n * @param {Number} begin\n * @param {Number} end\n * @returns {ShallowWrapper}\n */\n slice(begin, end) {\n return this.wrap(this.getNodesInternal().slice(begin, end));\n }\n\n /**\n * Returns whether or not any of the nodes in the wrapper match the provided selector.\n *\n * @param {EnzymeSelector} selector\n * @returns {Boolean}\n */\n some(selector) {\n if (this[ROOT] === this) {\n throw new Error('ReactWrapper::some() can not be called on the root');\n }\n const predicate = buildPredicate(selector);\n return this.getNodesInternal().some(predicate);\n }\n\n /**\n * Returns whether or not any of the nodes in the wrapper pass the provided predicate function.\n *\n * @param {Function} predicate\n * @returns {Boolean}\n */\n someWhere(predicate) {\n return this.getNodesInternal().some((n, i) => predicate.call(this, this.wrap(n), i));\n }\n\n /**\n * Returns whether or not all of the nodes in the wrapper match the provided selector.\n *\n * @param {EnzymeSelector} selector\n * @returns {Boolean}\n */\n every(selector) {\n const predicate = buildPredicate(selector);\n return this.getNodesInternal().every(predicate);\n }\n\n /**\n * Returns whether or not any of the nodes in the wrapper pass the provided predicate function.\n *\n * @param {Function} predicate\n * @returns {Boolean}\n */\n everyWhere(predicate) {\n return this.getNodesInternal().every((n, i) => predicate.call(this, this.wrap(n), i));\n }\n\n /**\n * Utility method used to create new wrappers with a mapping function that returns an array of\n * nodes in response to a single node wrapper. The returned wrapper is a single wrapper around\n * all of the mapped nodes flattened (and de-duplicated).\n *\n * @param {Function} fn\n * @returns {ReactWrapper}\n */\n flatMap(fn) {\n const nodes = this.getNodesInternal().map((n, i) => fn.call(this, this.wrap(n), i));\n const flattened = flat(nodes, 1);\n return this.wrap(flattened.filter(Boolean));\n }\n\n /**\n * Finds all nodes in the current wrapper nodes' render trees that match the provided predicate\n * function.\n *\n * @param {Function} predicate\n * @returns {ReactWrapper}\n */\n findWhere(predicate) {\n return findWhereUnwrapped(this, (n) => {\n const node = this.wrap(n);\n return node.length > 0 && predicate(node);\n });\n }\n\n /**\n * Returns the node at a given index of the current wrapper.\n *\n * @param {Number} index\n * @returns {ReactElement}\n */\n get(index) {\n return this.getElements()[index];\n }\n\n /**\n * Returns a wrapper around the node at a given index of the current wrapper.\n *\n * @param {Number} index\n * @returns {ReactWrapper}\n */\n at(index) {\n const nodes = this.getNodesInternal();\n if (index < nodes.length) {\n return this.wrap(nodes[index]);\n }\n return this.wrap([]);\n }\n\n /**\n * Returns a wrapper around the first node of the current wrapper.\n *\n * @returns {ReactWrapper}\n */\n first() {\n return this.at(0);\n }\n\n /**\n * Returns a wrapper around the last node of the current wrapper.\n *\n * @returns {ReactWrapper}\n */\n last() {\n return this.at(this.length - 1);\n }\n\n /**\n * Delegates to exists()\n *\n * @returns {boolean}\n */\n isEmpty() {\n // eslint-disable-next-line no-console\n console.warn('Enzyme::Deprecated method isEmpty() called, use exists() instead.');\n return !this.exists();\n }\n\n /**\n * Returns true if the current wrapper has nodes. False otherwise.\n * If called with a selector it returns `.find(selector).exists()` instead.\n *\n * @param {EnzymeSelector} selector (optional)\n * @returns {boolean}\n */\n exists(selector = null) {\n return arguments.length > 0 ? this.find(selector).exists() : this.length > 0;\n }\n\n /**\n * Utility method that throws an error if the current instance has a length other than one.\n * This is primarily used to enforce that certain methods are only run on a wrapper when it is\n * wrapping a single node.\n *\n * @param {Function} fn\n * @returns {*}\n */\n single(name, fn) {\n const fnName = typeof name === 'string' ? name : 'unknown';\n const callback = typeof fn === 'function' ? fn : name;\n if (this.length !== 1) {\n throw new Error(`Method “${fnName}” is meant to be run on 1 node. ${this.length} found instead.`);\n }\n return callback.call(this, this.getNodeInternal());\n }\n\n /**\n * Helpful utility method to create a new wrapper with the same root as the current wrapper, with\n * any nodes passed in as the first parameter automatically wrapped.\n *\n * @param {ReactWrapper|ReactElement|Array} node\n * @returns {ReactWrapper}\n */\n wrap(node, root = this[ROOT], ...args) {\n if (node instanceof ReactWrapper) {\n return node;\n }\n return new ReactWrapper(node, root, ...args);\n }\n\n /**\n * Returns an HTML-like string of the shallow render for debugging purposes.\n *\n * @param {Object} [options] - Property bag of additional options.\n * @param {boolean} [options.ignoreProps] - if true, props are omitted from the string.\n * @param {boolean} [options.verbose] - if true, arrays and objects to be verbosely printed.\n * @returns {String}\n */\n debug(options = {}) {\n return debugNodes(this.getNodesInternal(), options);\n }\n\n /**\n * Invokes intercepter and returns itself. intercepter is called with itself.\n * This is helpful when debugging nodes in method chains.\n * @param fn\n * @returns {ReactWrapper}\n */\n tap(intercepter) {\n intercepter(this);\n return this;\n }\n\n /**\n * Detaches the react tree from the DOM. Runs `ReactDOM.unmountComponentAtNode()` under the hood.\n *\n * This method will most commonly be used as a \"cleanup\" method if you decide to use the\n * `attachTo` option in `mount(node, options)`.\n *\n * The method is intentionally not \"fluent\" (in that it doesn't return `this`) because you should\n * not be doing anything with this wrapper after this method is called.\n */\n detach() {\n if (this[ROOT] !== this) {\n throw new Error('ReactWrapper::detach() can only be called on the root');\n }\n if (!this[OPTIONS].attachTo) {\n throw new Error('ReactWrapper::detach() can only be called on when the `attachTo` option was passed into `mount()`.');\n }\n this[RENDERER].unmount();\n }\n\n /**\n * Strips out all the not host-nodes from the list of nodes\n *\n * This method is useful if you want to check for the presence of host nodes\n * (actually rendered HTML elements) ignoring the React nodes.\n */\n hostNodes() {\n return this.filterWhere((n) => typeof n.type() === 'string');\n }\n}\n\n/**\n * A *special* \"root\" wrapper that represents the component passed as `wrappingComponent`.\n * It is linked to the primary root such that updates to it will update the primary,\n * and vice versa.\n *\n * @class WrappingComponentWrapper\n */\nclass WrappingComponentWrapper extends ReactWrapper {\n /* eslint-disable class-methods-use-this */\n constructor(root, renderer) {\n super(renderer.getNode(), root);\n\n privateSet(this, ROOT, this);\n privateSet(this, RENDERER, renderer);\n this[LINKED_ROOTS].push(root);\n }\n\n getWrappingComponent() {\n throw new TypeError('ReactWrapper::getWrappingComponent() can only be called on the root');\n }\n}\n\nif (ITERATOR_SYMBOL) {\n Object.defineProperty(ReactWrapper.prototype, ITERATOR_SYMBOL, {\n configurable: true,\n value: function iterator() {\n const iter = this[NODES][ITERATOR_SYMBOL]();\n const adapter = getAdapter(this[OPTIONS]);\n return {\n [ITERATOR_SYMBOL]() { return this; },\n next() {\n const next = iter.next();\n if (next.done) {\n return { done: true };\n }\n return {\n done: false,\n value: adapter.nodeToElement(next.value),\n };\n },\n };\n },\n });\n}\n\nfunction privateWarning(prop, extraMessage) {\n Object.defineProperty(ReactWrapper.prototype, prop, {\n get() {\n throw new Error(trim(`\n Attempted to access ReactWrapper::${prop}, which was previously a private property on\n Enzyme ReactWrapper instances, but is no longer and should not be relied upon.\n ${extraMessage}\n `));\n },\n enumerable: false,\n configurable: false,\n });\n}\n\nprivateWarning('node', 'Consider using the getElement() method instead.');\nprivateWarning('nodes', 'Consider using the getElements() method instead.');\nprivateWarning('renderer', '');\nprivateWarning('options', '');\nprivateWarning('complexSelector', '');\n\nexport default ReactWrapper;\n" }, { "path": "packages/enzyme/src/ShallowWrapper.js", "content": "import flat from 'array.prototype.flat';\nimport hasOwn from 'hasown';\nimport shallowEqual from 'enzyme-shallow-equal';\nimport trim from 'string.prototype.trim';\n\nimport {\n nodeEqual,\n nodeMatches,\n containsChildrenSubArray,\n withSetStateAllowed,\n typeOfNode,\n isReactElementAlike,\n displayNameOfNode,\n isCustomComponent,\n isCustomComponentElement,\n ITERATOR_SYMBOL,\n makeOptions,\n sym,\n privateSet,\n cloneElement,\n spyMethod,\n isEmptyValue,\n loadCheerioRoot,\n} from './Utils';\nimport getAdapter from './getAdapter';\nimport { debugNodes } from './Debug';\nimport {\n propsOfNode,\n getTextFromNode,\n hasClassName,\n childrenOfNode,\n parentsOfNode,\n treeFilter,\n} from './RSTTraversal';\nimport { buildPredicate, reduceTreesBySelector } from './selectors';\n\nconst NODE = sym('__node__');\nconst NODES = sym('__nodes__');\nconst RENDERER = sym('__renderer__');\nconst UNRENDERED = sym('__unrendered__');\nconst ROOT = sym('__root__');\nconst OPTIONS = sym('__options__');\nconst SET_STATE = sym('__setState__');\nconst ROOT_NODES = sym('__rootNodes__');\nconst CHILD_CONTEXT = sym('__childContext__');\nconst WRAPPING_COMPONENT = sym('__wrappingComponent__');\nconst PRIMARY_WRAPPER = sym('__primaryWrapper__');\nconst ROOT_FINDER = sym('__rootFinder__');\nconst PROVIDER_VALUES = sym('__providerValues__');\n\n/**\n * Finds all nodes in the current wrapper nodes' render trees that match the provided predicate\n * function.\n *\n * @param {ShallowWrapper} wrapper\n * @param {Function} predicate\n * @param {Function} filter\n * @returns {ShallowWrapper}\n */\nfunction findWhereUnwrapped(wrapper, predicate, filter = treeFilter) {\n return wrapper.flatMap((n) => filter(n.getNodeInternal(), predicate));\n}\n\n/**\n * Returns a new wrapper instance with only the nodes of the current wrapper instance that match\n * the provided predicate function.\n *\n * @param {ShallowWrapper} wrapper\n * @param {Function} predicate\n * @returns {ShallowWrapper}\n */\nfunction filterWhereUnwrapped(wrapper, predicate) {\n return wrapper.wrap(wrapper.getNodesInternal().filter(predicate).filter(Boolean));\n}\n\n/**\n * Ensure options passed to ShallowWrapper are valid. Throws otherwise.\n * @param {Object} options\n */\nfunction validateOptions(options) {\n const {\n lifecycleExperimental,\n disableLifecycleMethods,\n enableComponentDidUpdateOnSetState,\n supportPrevContextArgumentOfComponentDidUpdate,\n lifecycles = {},\n } = options;\n if (typeof lifecycleExperimental !== 'undefined' && typeof lifecycleExperimental !== 'boolean') {\n throw new Error('lifecycleExperimental must be either true or false if provided');\n }\n\n if (typeof disableLifecycleMethods !== 'undefined' && typeof disableLifecycleMethods !== 'boolean') {\n throw new Error('disableLifecycleMethods must be either true or false if provided');\n }\n\n if (\n lifecycleExperimental != null\n && disableLifecycleMethods != null\n && lifecycleExperimental === disableLifecycleMethods\n ) {\n throw new Error('lifecycleExperimental and disableLifecycleMethods cannot be set to the same value');\n }\n\n if (\n typeof enableComponentDidUpdateOnSetState !== 'undefined'\n && lifecycles.componentDidUpdate\n && lifecycles.componentDidUpdate.onSetState !== enableComponentDidUpdateOnSetState\n ) {\n throw new TypeError('the legacy enableComponentDidUpdateOnSetState option should be matched by `lifecycles: { componentDidUpdate: { onSetState: true } }`, for compatibility');\n }\n\n if (\n typeof supportPrevContextArgumentOfComponentDidUpdate !== 'undefined'\n && lifecycles.componentDidUpdate\n && lifecycles.componentDidUpdate.prevContext !== supportPrevContextArgumentOfComponentDidUpdate\n ) {\n throw new TypeError('the legacy supportPrevContextArgumentOfComponentDidUpdate option should be matched by `lifecycles: { componentDidUpdate: { prevContext: true } }`, for compatibility');\n }\n}\n\nfunction getAdapterLifecycles({ options }) {\n const {\n lifecycles = {},\n enableComponentDidUpdateOnSetState,\n supportPrevContextArgumentOfComponentDidUpdate,\n } = options;\n\n const hasLegacySetStateArg = typeof enableComponentDidUpdateOnSetState !== 'undefined';\n const hasLegacyPrevContextArg = typeof supportPrevContextArgumentOfComponentDidUpdate !== 'undefined';\n const componentDidUpdate = hasLegacySetStateArg || hasLegacyPrevContextArg\n ? {\n ...(hasLegacySetStateArg && {\n onSetState: !!enableComponentDidUpdateOnSetState,\n }),\n ...(hasLegacyPrevContextArg && {\n prevContext: !!supportPrevContextArgumentOfComponentDidUpdate,\n }),\n }\n : null;\n const { getDerivedStateFromProps: originalGDSFP } = lifecycles;\n const getDerivedStateFromProps = originalGDSFP ? {\n hasShouldComponentUpdateBug: !!originalGDSFP.hasShouldComponentUpdateBug,\n } : false;\n\n return {\n ...lifecycles,\n setState: {\n ...lifecycles.setState,\n },\n getChildContext: {\n calledByRenderer: true,\n ...lifecycles.getChildContext,\n },\n ...(componentDidUpdate && { componentDidUpdate }),\n getDerivedStateFromProps,\n };\n}\n\nfunction getRootNode(node) {\n if (node.nodeType === 'host') {\n return node;\n }\n return node.rendered;\n}\n\nfunction getRootNodeInternal(wrapper) {\n if (wrapper[ROOT].length !== 1) {\n throw new Error('getRootNodeInternal(wrapper) can only be called when wrapper wraps one node');\n }\n if (wrapper[ROOT] !== wrapper) {\n return wrapper[ROOT_NODES][0];\n }\n return wrapper[ROOT][NODE];\n}\n\nfunction nodeParents(wrapper, node) {\n return parentsOfNode(node, getRootNodeInternal(wrapper));\n}\n\nfunction privateSetNodes(wrapper, nodes) {\n if (!Array.isArray(nodes)) {\n privateSet(wrapper, NODE, nodes);\n privateSet(wrapper, NODES, [nodes]);\n } else {\n privateSet(wrapper, NODE, nodes[0]);\n privateSet(wrapper, NODES, nodes);\n }\n privateSet(wrapper, 'length', wrapper[NODES].length);\n}\n\nfunction pureComponentShouldComponentUpdate(prevProps, props, prevState, state) {\n return !shallowEqual(prevProps, props) || !shallowEqual(prevState, state);\n}\n\nfunction isPureComponent(instance) {\n return instance && instance.isPureReactComponent;\n}\n\nfunction getChildContext(node, hierarchy, renderer) {\n const { instance, type: Component } = node;\n const componentName = displayNameOfNode(node);\n // Warn like react if childContextTypes is not defined:\n // https://github.com/facebook/react/blob/1454a8be03794f5e0b23a7e7696cbbbdcf8b0f5d/packages/react-dom/src/server/ReactPartialRenderer.js#L639-L646\n if (typeof Component.childContextTypes !== 'object') {\n // eslint-disable-next-line no-console\n console.warn(\n `${componentName}.getChildContext(): childContextTypes must be defined in order to use getChildContext().`,\n );\n return {};\n }\n // Check childContextTypes like react:\n // https://github.com/facebook/react/blob/1454a8be03794f5e0b23a7e7696cbbbdcf8b0f5d/packages/react-dom/src/server/ReactPartialRenderer.js#L630-L637\n const childContext = instance.getChildContext();\n Object.keys(childContext).forEach((key) => {\n if (!(key in Component.childContextTypes)) {\n throw new Error(\n `${componentName}.getChildContext(): key \"${key}\" is not defined in childContextTypes.`,\n );\n }\n });\n if (typeof renderer.checkPropTypes === 'function') {\n renderer.checkPropTypes(Component.childContextTypes, childContext, 'child context', hierarchy);\n }\n return childContext;\n}\n\nfunction spyOnGetChildContextInitialRender(nodes, adapter) {\n if (\n !isCustomComponentElement(nodes, adapter)\n || !nodes.type.prototype\n || typeof nodes.type.prototype.getChildContext !== 'function'\n ) {\n return null;\n }\n\n return spyMethod(nodes.type.prototype, 'getChildContext');\n}\n\nfunction privateSetChildContext(adapter, wrapper, instance, renderedNode, getChildContextSpy) {\n const renderer = wrapper[RENDERER];\n // We only support parent-based context.\n if (adapter.options.legacyContextMode !== 'parent') { return; }\n if (getChildContextSpy) {\n privateSet(wrapper, CHILD_CONTEXT, getChildContextSpy.getLastReturnValue());\n getChildContextSpy.restore();\n } else if (typeof instance.getChildContext === 'function') {\n // If there's no spy but getChildContext is a function, that means our renderer\n // is not going to call it for us, so we need to call it ourselves.\n const nodeHierarchy = [wrapper[NODE]].concat(nodeParents(wrapper, wrapper[NODE]));\n const childContext = getChildContext(renderedNode, nodeHierarchy, renderer);\n privateSet(wrapper, CHILD_CONTEXT, childContext);\n } else {\n privateSet(wrapper, CHILD_CONTEXT, null);\n }\n}\n\nfunction mockSCUIfgDSFPReturnNonNull(node, state) {\n const { getDerivedStateFromProps } = node.type;\n\n if (typeof getDerivedStateFromProps === 'function') {\n // we try to fix a React shallow renderer bug here.\n // (facebook/react#14607, which has been fixed in react 16.8):\n // when gDSFP return derived state, it will set instance state in shallow renderer before SCU,\n // this will cause `this.state` in sCU be the updated state, which is wrong behavior.\n // so we have to wrap sCU to pass the old state to original sCU.\n const { instance } = node;\n const { restore } = spyMethod(\n instance,\n 'shouldComponentUpdate',\n (originalSCU) => function shouldComponentUpdate(...args) {\n instance.state = state;\n const sCUResult = originalSCU.apply(instance, args);\n const [, nextState] = args;\n instance.state = nextState;\n restore();\n return sCUResult;\n },\n );\n }\n}\n\n/**\n * Recursively dive()s every custom component in a wrapper until\n * the target component is found.\n *\n * @param {ShallowWrapper} wrapper A ShallowWrapper to search\n * @param {ComponentType} target A react custom component that, when found, will end recursion\n * @param {Adapter} adapter An Enzyme adapter\n * @returns {ShallowWrapper|undefined} A ShallowWrapper for the target, or\n * undefined if it can't be found\n */\nfunction deepRender(wrapper, target, adapter) {\n const node = wrapper[NODE];\n const element = node && adapter.nodeToElement(node);\n if (wrapper.type() === target) {\n return wrapper.dive();\n }\n if (element && isCustomComponentElement(element, adapter)) {\n return deepRender(wrapper.dive(), target, adapter);\n }\n const children = wrapper.children();\n for (let i = 0; i < children.length; i += 1) {\n const found = deepRender(children.at(i), target, adapter);\n if (typeof found !== 'undefined') {\n return found;\n }\n }\n return undefined;\n}\n\n/**\n * Deep-renders the `wrappingComponent` and returns the context that should\n * be accessible to the primary wrapper.\n *\n * @param {WrappingComponentWrapper} wrapper The `WrappingComponentWrapper` for a\n * `wrappingComponent`\n * @param {Adapter} adapter An Enzyme adapter\n * @returns {object} An object containing an object of legacy context values and a Map of\n * `createContext()` Provider values.\n */\nfunction getContextFromWrappingComponent(wrapper, adapter) {\n const rootFinder = deepRender(wrapper, wrapper[ROOT_FINDER], adapter);\n if (!rootFinder) {\n throw new Error('`wrappingComponent` must render its children!');\n }\n return {\n legacyContext: rootFinder[OPTIONS].context,\n providerValues: rootFinder[PROVIDER_VALUES],\n };\n}\n\n/**\n * Makes options specifically for `ShallowWrapper`. Most of the logic here is around rendering\n * a `wrappingComponent` (if one was provided) and adding the child context of that component\n * to `options.context`.\n *\n * @param {ReactElement} nodes the nodes passed to `ShallowWrapper`\n * @param {ShallowWrapper} root this `ShallowWrapper`'s parent. If this is passed, options are\n * not transformed.\n * @param {*} passedOptions the options passed to `ShallowWrapper`.\n * @param {*} wrapper the `ShallowWrapper` itself\n * @returns {Object} the decorated and transformed options\n */\nfunction makeShallowOptions(nodes, root, passedOptions, wrapper) {\n const options = makeOptions(passedOptions);\n const adapter = getAdapter(passedOptions);\n privateSet(options, PROVIDER_VALUES, passedOptions[PROVIDER_VALUES]);\n if (root || !isCustomComponent(options.wrappingComponent, adapter)) {\n return options;\n }\n if (typeof adapter.wrapWithWrappingComponent !== 'function') {\n throw new TypeError('your adapter does not support `wrappingComponent`. Try upgrading it!');\n }\n const { node: wrappedNode, RootFinder } = adapter.wrapWithWrappingComponent(nodes, options);\n // eslint-disable-next-line no-use-before-define\n const wrappingComponent = new WrappingComponentWrapper(wrappedNode, wrapper, RootFinder);\n const {\n legacyContext: wrappingComponentLegacyContext,\n providerValues: wrappingComponentProviderValues,\n } = getContextFromWrappingComponent(wrappingComponent, adapter);\n privateSet(wrapper, WRAPPING_COMPONENT, wrappingComponent);\n return {\n ...options,\n context: {\n ...options.context,\n ...wrappingComponentLegacyContext,\n },\n [PROVIDER_VALUES]: wrappingComponentProviderValues,\n };\n}\n\nfunction makeInheritedChildOptions(wrapper, options = {}) {\n const childOptions = {\n ...wrapper[OPTIONS],\n ...options,\n context: options.context || {\n ...wrapper[OPTIONS].context,\n ...wrapper[ROOT][CHILD_CONTEXT],\n },\n };\n privateSet(childOptions, PROVIDER_VALUES, wrapper[ROOT][PROVIDER_VALUES]);\n return childOptions;\n}\n\n/**\n * @class ShallowWrapper\n */\nclass ShallowWrapper {\n constructor(nodes, root, passedOptions = {}) {\n validateOptions(passedOptions);\n\n const options = makeShallowOptions(nodes, root, passedOptions, this);\n const adapter = getAdapter(options);\n const lifecycles = getAdapterLifecycles(adapter);\n\n // mounting a ShallowRender component\n if (!root) {\n if (!adapter.isValidElement(nodes)) {\n throw new TypeError('ShallowWrapper can only wrap valid elements');\n }\n\n const getChildContextSpy = lifecycles.getChildContext.calledByRenderer\n ? spyOnGetChildContextInitialRender(nodes, adapter)\n : null;\n privateSet(this, ROOT, this);\n privateSet(this, UNRENDERED, nodes);\n const renderer = adapter.createRenderer({ mode: 'shallow', ...options });\n privateSet(this, RENDERER, renderer);\n const providerValues = new Map(options[PROVIDER_VALUES] || []);\n this[RENDERER].render(nodes, options.context, { providerValues });\n const renderedNode = this[RENDERER].getNode();\n privateSetNodes(this, getRootNode(renderedNode));\n privateSet(this, OPTIONS, options);\n privateSet(this, PROVIDER_VALUES, providerValues);\n\n const { instance } = renderedNode;\n if (instance && !options.disableLifecycleMethods) {\n // Ensure to call componentDidUpdate when instance.setState is called\n if (lifecycles.componentDidUpdate.onSetState && !instance[SET_STATE]) {\n privateSet(instance, SET_STATE, instance.setState);\n instance.setState = (updater, callback = undefined) => this.setState(\n ...(callback == null ? [updater] : [updater, callback]),\n );\n }\n\n if (typeof instance.componentDidMount === 'function') {\n this[RENDERER].batchedUpdates(() => {\n instance.componentDidMount();\n });\n }\n privateSetChildContext(adapter, this, instance, renderedNode, getChildContextSpy);\n }\n // creating a child component through enzyme's ShallowWrapper APIs.\n } else {\n privateSet(this, ROOT, root);\n privateSet(this, UNRENDERED, null);\n privateSet(this, RENDERER, root[RENDERER]);\n privateSetNodes(this, nodes);\n privateSet(this, OPTIONS, root[OPTIONS]);\n privateSet(this, ROOT_NODES, root[NODES]);\n privateSet(this, PROVIDER_VALUES, null);\n }\n }\n\n /**\n * Returns the root wrapper\n *\n * @return {ShallowWrapper}\n */\n root() {\n return this[ROOT];\n }\n\n /**\n * Returns the wrapped component.\n *\n * @return {ReactComponent}\n */\n getNodeInternal() {\n if (this.length !== 1) {\n throw new Error('ShallowWrapper::getNode() can only be called when wrapping one node');\n }\n if (this[ROOT] === this) {\n this.update();\n }\n return this[NODE];\n }\n\n /**\n * Returns the the wrapped components.\n *\n * @return {Array}\n */\n getNodesInternal() {\n if (this[ROOT] === this && this.length === 1) {\n this.update();\n }\n return this[NODES];\n }\n\n /**\n * Returns the wrapped ReactElement.\n *\n * @return {ReactElement}\n */\n getElement() {\n return this.single('getElement', (n) => getAdapter(this[OPTIONS]).nodeToElement(n));\n }\n\n /**\n * Returns the wrapped ReactElements.\n *\n * @return {Array}\n */\n getElements() {\n return this.getNodesInternal().map((n) => getAdapter(this[OPTIONS]).nodeToElement(n));\n }\n\n // eslint-disable-next-line class-methods-use-this\n getNode() {\n throw new Error('ShallowWrapper::getNode() is no longer supported. Use ShallowWrapper::getElement() instead');\n }\n\n // eslint-disable-next-line class-methods-use-this\n getNodes() {\n throw new Error('ShallowWrapper::getNodes() is no longer supported. Use ShallowWrapper::getElements() instead');\n }\n\n /**\n * Gets the instance of the component being rendered as the root node passed into `shallow()`.\n *\n * NOTE: can only be called on a wrapper instance that is also the root instance.\n *\n * Example:\n * ```\n * const wrapper = shallow();\n * const inst = wrapper.instance();\n * expect(inst).to.be.instanceOf(MyComponent);\n * ```\n * @returns {ReactComponent}\n */\n instance() {\n if (this[ROOT] !== this) {\n throw new Error('ShallowWrapper::instance() can only be called on the root');\n }\n return this[RENDERER].getNode().instance;\n }\n\n /**\n * If a `wrappingComponent` was passed in `options`, this methods returns a `ShallowWrapper`\n * around the rendered `wrappingComponent`. This `ShallowWrapper` can be used to update the\n * `wrappingComponent`'s props, state, etc.\n *\n * @returns ShallowWrapper\n */\n getWrappingComponent() {\n if (this[ROOT] !== this) {\n throw new Error('ShallowWrapper::getWrappingComponent() can only be called on the root');\n }\n if (!this[OPTIONS].wrappingComponent) {\n throw new Error('ShallowWrapper::getWrappingComponent() can only be called on a wrapper that was originally passed a `wrappingComponent` option');\n }\n return this[WRAPPING_COMPONENT];\n }\n\n /**\n * Forces a re-render. Useful to run before checking the render output if something external\n * may be updating the state of the component somewhere.\n *\n * NOTE: can only be called on a wrapper instance that is also the root instance.\n *\n * @returns {ShallowWrapper}\n */\n update() {\n if (this[ROOT] !== this) {\n throw new Error('ShallowWrapper::update() can only be called on the root');\n }\n if (this.length !== 1) {\n throw new Error('ShallowWrapper::update() can only be called when wrapping one node');\n }\n privateSetNodes(this, getRootNode(this[RENDERER].getNode()));\n return this;\n }\n\n /**\n * A method that unmounts the component. This can be used to simulate a component going through\n * and unmount/mount lifecycle.\n * @returns {ShallowWrapper}\n */\n unmount() {\n this[RENDERER].unmount();\n if (this[ROOT][WRAPPING_COMPONENT]) {\n this[ROOT][WRAPPING_COMPONENT].unmount();\n }\n return this;\n }\n\n /**\n * A method is for re-render with new props and context.\n * This calls componentDidUpdate method if disableLifecycleMethods is not enabled.\n *\n * NOTE: can only be called on a wrapper instance that is also the root instance.\n *\n * @param {Object} props\n * @param {Object} context\n * @returns {ShallowWrapper}\n */\n rerender(props, context) {\n const adapter = getAdapter(this[OPTIONS]);\n this.single('rerender', () => {\n withSetStateAllowed(() => {\n // NOTE(lmr): In react 16, instances will be null for SFCs, but\n // rerendering with props/context is still a valid thing to do. In\n // this case, state will be undefined, but props/context will exist.\n const node = this[RENDERER].getNode();\n const instance = node.instance || {};\n const type = node.type || {};\n const { state } = instance;\n const prevProps = instance.props || this[UNRENDERED].props;\n const prevContext = instance.context || this[OPTIONS].context;\n const nextContext = context || prevContext;\n if (context) {\n this[OPTIONS] = { ...this[OPTIONS], context: nextContext };\n }\n this[RENDERER].batchedUpdates(() => {\n // When shouldComponentUpdate returns false we shouldn't call componentDidUpdate.\n // so we spy shouldComponentUpdate to get the result.\n const lifecycles = getAdapterLifecycles(adapter);\n let shouldRender = true;\n let shouldComponentUpdateSpy;\n let getChildContextSpy;\n if (\n !this[OPTIONS].disableLifecycleMethods\n && instance\n ) {\n if (typeof instance.shouldComponentUpdate === 'function') {\n const { getDerivedStateFromProps: gDSFP } = lifecycles;\n if (gDSFP && gDSFP.hasShouldComponentUpdateBug) {\n mockSCUIfgDSFPReturnNonNull(node, state);\n }\n shouldComponentUpdateSpy = spyMethod(instance, 'shouldComponentUpdate');\n }\n if (\n lifecycles.getChildContext.calledByRenderer\n && typeof instance.getChildContext === 'function'\n ) {\n getChildContextSpy = spyMethod(instance, 'getChildContext');\n }\n }\n if (!shouldComponentUpdateSpy && isPureComponent(instance)) {\n shouldRender = pureComponentShouldComponentUpdate(\n prevProps,\n props,\n state,\n instance.state,\n );\n }\n if (props) this[UNRENDERED] = cloneElement(adapter, this[UNRENDERED], props);\n this[RENDERER].render(this[UNRENDERED], nextContext, {\n providerValues: this[PROVIDER_VALUES],\n });\n if (shouldComponentUpdateSpy) {\n shouldRender = shouldComponentUpdateSpy.getLastReturnValue();\n shouldComponentUpdateSpy.restore();\n }\n if (\n shouldRender\n && !this[OPTIONS].disableLifecycleMethods\n && instance\n ) {\n privateSetChildContext(adapter, this, instance, node, getChildContextSpy);\n if (lifecycles.getSnapshotBeforeUpdate) {\n let snapshot;\n if (typeof instance.getSnapshotBeforeUpdate === 'function') {\n snapshot = instance.getSnapshotBeforeUpdate(prevProps, state);\n }\n if (\n lifecycles.componentDidUpdate\n && typeof instance.componentDidUpdate === 'function'\n && (\n !state\n || shallowEqual(state, this.instance().state)\n || typeof type.getDerivedStateFromProps === 'function'\n )\n ) {\n instance.componentDidUpdate(prevProps, state, snapshot);\n }\n } else if (\n lifecycles.componentDidUpdate\n && typeof instance.componentDidUpdate === 'function'\n ) {\n if (lifecycles.componentDidUpdate.prevContext) {\n instance.componentDidUpdate(prevProps, state, prevContext);\n } else if (!state || shallowEqual(this.instance().state, state)) {\n instance.componentDidUpdate(prevProps, state);\n }\n }\n // If it doesn't need to rerender, update only its props.\n } else if (!shallowEqual(props, instance.props)) {\n instance.props = (Object.freeze || Object)({ ...instance.props, ...props });\n }\n this.update();\n });\n });\n });\n return this;\n }\n\n /**\n * A method that sets the props of the root component, and re-renders. Useful for when you are\n * wanting to test how the component behaves over time with changing props. Calling this, for\n * instance, will call the `componentWillReceiveProps` lifecycle method.\n *\n * Similar to `setState`, this method accepts a props object and will merge it in with the already\n * existing props.\n *\n * NOTE: can only be called on a wrapper instance that is also the root instance.\n *\n * @param {Object} props object\n * @param {Function} cb - callback function\n * @returns {ShallowWrapper}\n */\n setProps(props, callback = undefined) {\n if (this[ROOT] !== this) {\n throw new Error('ShallowWrapper::setProps() can only be called on the root');\n }\n if (arguments.length > 1 && typeof callback !== 'function') {\n throw new TypeError('ReactWrapper::setProps() expects a function as its second argument');\n }\n this.rerender(props);\n if (callback) {\n callback();\n }\n return this;\n }\n\n /**\n * A method to invoke `setState` on the root component instance similar to how you might in the\n * definition of the component, and re-renders. This method is useful for testing your component\n * in hard to achieve states, however should be used sparingly. If possible, you should utilize\n * your component's external API in order to get it into whatever state you want to test, in order\n * to be as accurate of a test as possible. This is not always practical, however.\n *\n * NOTE: can only be called on a wrapper instance that is also the root instance.\n *\n * @param {Object} state to merge\n * @param {Function} cb - callback function\n * @returns {ShallowWrapper}\n */\n setState(state, callback = undefined) {\n if (this[ROOT] !== this) {\n throw new Error('ShallowWrapper::setState() can only be called on the root');\n }\n if (this.instance() === null || this[RENDERER].getNode().nodeType !== 'class') {\n throw new Error('ShallowWrapper::setState() can only be called on class components');\n }\n if (arguments.length > 1 && typeof callback !== 'function') {\n throw new TypeError('ReactWrapper::setState() expects a function as its second argument');\n }\n\n this.single('setState', () => {\n withSetStateAllowed(() => {\n const adapter = getAdapter(this[OPTIONS]);\n\n const lifecycles = getAdapterLifecycles(adapter);\n\n const node = this[RENDERER].getNode();\n const { instance } = node;\n const prevProps = instance.props;\n const prevState = instance.state;\n const prevContext = instance.context;\n\n const statePayload = typeof state === 'function'\n ? state.call(instance, prevState, prevProps)\n : state;\n\n // returning null or undefined prevents the update in React 16+\n // https://github.com/facebook/react/pull/12756\n const maybeHasUpdate = !lifecycles.setState.skipsComponentDidUpdateOnNullish\n || statePayload != null;\n\n // When shouldComponentUpdate returns false we shouldn't call componentDidUpdate.\n // so we spy shouldComponentUpdate to get the result.\n let shouldComponentUpdateSpy;\n let getChildContextSpy;\n let shouldRender = true;\n if (\n !this[OPTIONS].disableLifecycleMethods\n && instance\n ) {\n if (\n lifecycles.componentDidUpdate\n && lifecycles.componentDidUpdate.onSetState\n && typeof instance.shouldComponentUpdate === 'function'\n ) {\n const { getDerivedStateFromProps: gDSFP } = lifecycles;\n if (gDSFP && gDSFP.hasShouldComponentUpdateBug) {\n mockSCUIfgDSFPReturnNonNull(node, state);\n }\n shouldComponentUpdateSpy = spyMethod(instance, 'shouldComponentUpdate');\n }\n if (\n lifecycles.getChildContext.calledByRenderer\n && typeof instance.getChildContext === 'function'\n ) {\n getChildContextSpy = spyMethod(instance, 'getChildContext');\n }\n }\n if (!shouldComponentUpdateSpy && isPureComponent(instance)) {\n shouldRender = pureComponentShouldComponentUpdate(\n prevProps,\n instance.props,\n prevState,\n { ...prevState, ...statePayload },\n );\n }\n\n // We don't pass the setState callback here\n // to guarantee to call the callback after finishing the render\n if (instance[SET_STATE]) {\n instance[SET_STATE](statePayload);\n } else {\n instance.setState(statePayload);\n }\n if (shouldComponentUpdateSpy) {\n shouldRender = shouldComponentUpdateSpy.getLastReturnValue();\n shouldComponentUpdateSpy.restore();\n }\n if (\n maybeHasUpdate\n && shouldRender\n && !this[OPTIONS].disableLifecycleMethods\n ) {\n privateSetChildContext(adapter, this, instance, node, getChildContextSpy);\n if (\n lifecycles.componentDidUpdate\n && lifecycles.componentDidUpdate.onSetState\n ) {\n if (\n lifecycles.getSnapshotBeforeUpdate\n && typeof instance.getSnapshotBeforeUpdate === 'function'\n ) {\n const snapshot = instance.getSnapshotBeforeUpdate(prevProps, prevState);\n if (typeof instance.componentDidUpdate === 'function') {\n instance.componentDidUpdate(prevProps, prevState, snapshot);\n }\n } else if (typeof instance.componentDidUpdate === 'function') {\n if (lifecycles.componentDidUpdate.prevContext) {\n instance.componentDidUpdate(prevProps, prevState, prevContext);\n } else {\n instance.componentDidUpdate(prevProps, prevState);\n }\n }\n }\n }\n this.update();\n // call the setState callback\n if (callback) {\n if (adapter.invokeSetStateCallback) {\n adapter.invokeSetStateCallback(instance, callback);\n } else {\n callback.call(instance);\n }\n }\n });\n });\n return this;\n }\n\n /**\n * A method that sets the context of the root component, and re-renders. Useful for when you are\n * wanting to test how the component behaves over time with changing contexts.\n *\n * NOTE: can only be called on a wrapper instance that is also the root instance.\n *\n * @param {Object} context object\n * @returns {ShallowWrapper}\n */\n setContext(context) {\n if (this[ROOT] !== this) {\n throw new Error('ShallowWrapper::setContext() can only be called on the root');\n }\n if (!this[OPTIONS].context) {\n throw new Error('ShallowWrapper::setContext() can only be called on a wrapper that was originally passed a context option');\n }\n return this.rerender(null, context);\n }\n\n /**\n * Whether or not a given react element exists in the shallow render tree.\n *\n * Example:\n * ```\n * const wrapper = shallow();\n * expect(wrapper.contains(
)).to.equal(true);\n * ```\n *\n * @param {ReactElement|Array} nodeOrNodes\n * @returns {Boolean}\n */\n contains(nodeOrNodes) {\n const adapter = getAdapter(this[OPTIONS]);\n if (!isReactElementAlike(nodeOrNodes, adapter)) {\n throw new Error('ShallowWrapper::contains() can only be called with a ReactElement (or an array of them), a string, or a number as an argument.');\n }\n const predicate = Array.isArray(nodeOrNodes)\n ? (other) => containsChildrenSubArray(\n nodeEqual,\n other,\n nodeOrNodes.map((node) => adapter.elementToNode(node)),\n )\n : (other) => nodeEqual(adapter.elementToNode(nodeOrNodes), other);\n\n return findWhereUnwrapped(this, predicate).length > 0;\n }\n\n /**\n * Whether or not a given react element exists in the shallow render tree.\n * Match is based on the expected element and not on wrappers element.\n * It will determine if one of the wrappers element \"looks like\" the expected\n * element by checking if all props of the expected element are present\n * on the wrappers element and equals to each other.\n *\n * Example:\n * ```\n * // MyComponent outputs
Hello
\n * const wrapper = shallow();\n * expect(wrapper.containsMatchingElement(
Hello
)).to.equal(true);\n * ```\n *\n * @param {ReactElement} node\n * @returns {Boolean}\n */\n containsMatchingElement(node) {\n const adapter = getAdapter(this[OPTIONS]);\n const rstNode = adapter.elementToNode(node);\n const predicate = (other) => nodeMatches(rstNode, other, (a, b) => a <= b);\n return findWhereUnwrapped(this, predicate).length > 0;\n }\n\n /**\n * Whether or not all the given react elements exist in the shallow render tree.\n * Match is based on the expected element and not on wrappers element.\n * It will determine if one of the wrappers element \"looks like\" the expected\n * element by checking if all props of the expected element are present\n * on the wrappers element and equals to each other.\n *\n * Example:\n * ```\n * const wrapper = shallow();\n * expect(wrapper.containsAllMatchingElements([\n *
Hello
,\n *
Goodbye
,\n * ])).to.equal(true);\n * ```\n *\n * @param {Array} nodes\n * @returns {Boolean}\n */\n containsAllMatchingElements(nodes) {\n if (!Array.isArray(nodes)) {\n throw new TypeError('nodes should be an Array');\n }\n\n return nodes.every((node) => this.containsMatchingElement(node));\n }\n\n /**\n * Whether or not one of the given react elements exists in the shallow render tree.\n * Match is based on the expected element and not on wrappers element.\n * It will determine if one of the wrappers element \"looks like\" the expected\n * element by checking if all props of the expected element are present\n * on the wrappers element and equals to each other.\n *\n * Example:\n * ```\n * const wrapper = shallow();\n * expect(wrapper.containsAnyMatchingElements([\n *
Hello
,\n *
Goodbye
,\n * ])).to.equal(true);\n * ```\n *\n * @param {Array} nodes\n * @returns {Boolean}\n */\n containsAnyMatchingElements(nodes) {\n return Array.isArray(nodes) && nodes.some((node) => this.containsMatchingElement(node));\n }\n\n /**\n * Whether or not a given react element exists in the render tree.\n *\n * Example:\n * ```\n * const wrapper = shallow();\n * expect(wrapper.contains(
)).to.equal(true);\n * ```\n *\n * @param {ReactElement} node\n * @returns {Boolean}\n */\n equals(node) {\n return this.single('equals', () => nodeEqual(this.getNodeInternal(), node));\n }\n\n /**\n * Whether or not a given react element matches the render tree.\n * Match is based on the expected element and not on wrapper root node.\n * It will determine if the wrapper root node \"looks like\" the expected\n * element by checking if all props of the expected element are present\n * on the wrapper root node and equals to each other.\n *\n * Example:\n * ```\n * // MyComponent outputs
Hello
\n * const wrapper = shallow();\n * expect(wrapper.matchesElement(
Hello
)).to.equal(true);\n * ```\n *\n * @param {ReactElement} node\n * @returns {Boolean}\n */\n matchesElement(node) {\n return this.single('matchesElement', () => {\n const adapter = getAdapter(this[OPTIONS]);\n const rstNode = adapter.elementToNode(node);\n return nodeMatches(rstNode, this.getNodeInternal(), (a, b) => a <= b);\n });\n }\n\n /**\n * Finds every node in the render tree of the current wrapper that matches the provided selector.\n *\n * @param {EnzymeSelector} selector\n * @returns {ShallowWrapper}\n */\n find(selector) {\n return this.wrap(reduceTreesBySelector(selector, this.getNodesInternal()));\n }\n\n /**\n * Returns whether or not current node matches a provided selector.\n *\n * NOTE: can only be called on a wrapper of a single node.\n *\n * @param {EnzymeSelector} selector\n * @returns {boolean}\n */\n is(selector) {\n const predicate = buildPredicate(selector);\n return this.single('is', (n) => predicate(n));\n }\n\n /**\n * Returns true if the component rendered nothing, i.e., null or false.\n *\n * @returns {boolean}\n */\n isEmptyRender() {\n const nodes = this.getNodesInternal();\n\n return nodes.every((n) => isEmptyValue(n));\n }\n\n /**\n * Returns a new wrapper instance with only the nodes of the current wrapper instance that match\n * the provided predicate function. The predicate should receive a wrapped node as its first\n * argument.\n *\n * @param {Function} predicate\n * @returns {ShallowWrapper}\n */\n filterWhere(predicate) {\n return filterWhereUnwrapped(this, (n) => predicate(this.wrap(n)));\n }\n\n /**\n * Returns a new wrapper instance with only the nodes of the current wrapper instance that match\n * the provided selector.\n *\n * @param {EnzymeSelector} selector\n * @returns {ShallowWrapper}\n */\n filter(selector) {\n const predicate = buildPredicate(selector);\n return filterWhereUnwrapped(this, predicate);\n }\n\n /**\n * Returns a new wrapper instance with only the nodes of the current wrapper that did not match\n * the provided selector. Essentially the inverse of `filter`.\n *\n * @param {EnzymeSelector} selector\n * @returns {ShallowWrapper}\n */\n not(selector) {\n const predicate = buildPredicate(selector);\n return filterWhereUnwrapped(this, (n) => !predicate(n));\n }\n\n /**\n * Returns a string of the rendered text of the current render tree. This function should be\n * looked at with skepticism if being used to test what the actual HTML output of the component\n * will be. If that is what you would like to test, use enzyme's `render` function instead.\n *\n * NOTE: can only be called on a wrapper of a single node.\n *\n * @returns {String}\n */\n text() {\n return this.single('text', getTextFromNode);\n }\n\n /**\n * Returns the HTML of the node.\n *\n * NOTE: can only be called on a wrapper of a single node.\n *\n * @returns {String}\n */\n html() {\n return this.single('html', (n) => {\n if (this.type() === null) return null;\n const adapter = getAdapter(this[OPTIONS]);\n const renderer = adapter.createRenderer({ ...this[OPTIONS], mode: 'string' });\n return renderer.render(adapter.nodeToElement(n));\n });\n }\n\n /**\n * Returns the current node rendered to HTML and wrapped in a CheerioWrapper.\n *\n * NOTE: can only be called on a wrapper of a single node.\n *\n * @returns {CheerioWrapper}\n */\n render() {\n const html = this.html();\n return loadCheerioRoot(html);\n }\n\n /**\n * Used to simulate events. Pass an eventname and (optionally) event arguments. This method of\n * testing events should be met with some skepticism.\n *\n * @param {String} event\n * @param {Array} args\n * @returns {ShallowWrapper}\n */\n simulate(event, ...args) {\n return this.single('simulate', (n) => {\n this[RENDERER].simulateEvent(n, event, ...args);\n this[ROOT].update();\n return this;\n });\n }\n\n /**\n * Used to simulate throwing a rendering error. Pass an error to throw.\n *\n * @param {String} error\n * @returns {ShallowWrapper}\n */\n simulateError(error) {\n // in shallow, the \"root\" is the \"rendered\" thing.\n\n return this.single('simulateError', (thisNode) => {\n if (thisNode.nodeType === 'host') {\n throw new TypeError('ShallowWrapper::simulateError() can only be called on custom components');\n }\n\n const renderer = this[RENDERER];\n if (typeof renderer.simulateError !== 'function') {\n throw new TypeError('your adapter does not support `simulateError`. Try upgrading it!');\n }\n\n const rootNode = getRootNodeInternal(this);\n const nodeHierarchy = [thisNode].concat(nodeParents(this, thisNode));\n renderer.simulateError(nodeHierarchy, rootNode, error);\n\n return this;\n });\n }\n\n /**\n * Returns the props hash for the current node of the wrapper.\n *\n * NOTE: can only be called on a wrapper of a single node.\n *\n * @returns {Object}\n */\n props() {\n return this.single('props', propsOfNode);\n }\n\n /**\n * Returns the state hash for the root node of the wrapper. Optionally pass in a prop name and it\n * will return just that value.\n *\n * NOTE: can only be called on a wrapper of a single node.\n *\n * @param {String} name (optional)\n * @returns {*}\n */\n state(name) {\n if (this[ROOT] !== this) {\n throw new Error('ShallowWrapper::state() can only be called on the root');\n }\n if (this.instance() === null || this[RENDERER].getNode().nodeType !== 'class') {\n throw new Error('ShallowWrapper::state() can only be called on class components');\n }\n const _state = this.single('state', () => this.instance().state);\n if (typeof name !== 'undefined') {\n if (_state == null) {\n throw new TypeError(`ShallowWrapper::state(\"${name}\") requires that \\`state\\` not be \\`null\\` or \\`undefined\\``);\n }\n return _state[name];\n }\n return _state;\n }\n\n /**\n * Returns the context hash for the root node of the wrapper.\n * Optionally pass in a prop name and it will return just that value.\n *\n * NOTE: can only be called on a wrapper of a single node.\n *\n * @param {String} name (optional)\n * @returns {*}\n */\n context(name) {\n if (this[ROOT] !== this) {\n throw new Error('ShallowWrapper::context() can only be called on the root');\n }\n if (!this[OPTIONS].context) {\n throw new Error('ShallowWrapper::context() can only be called on a wrapper that was originally passed a context option');\n }\n if (this.instance() === null) {\n throw new Error('ShallowWrapper::context() can only be called on wrapped nodes that have a non-null instance');\n }\n const _context = this.single('context', () => this.instance().context);\n if (name) {\n return _context[name];\n }\n return _context;\n }\n\n /**\n * Returns a new wrapper with all of the children of the current wrapper.\n *\n * @param {EnzymeSelector} [selector]\n * @returns {ShallowWrapper}\n */\n children(selector) {\n const allChildren = this.flatMap((n) => childrenOfNode(n.getNodeInternal()));\n return selector ? allChildren.filter(selector) : allChildren;\n }\n\n /**\n * Returns a new wrapper with a specific child\n *\n * @param {Number} [index]\n * @returns {ShallowWrapper}\n */\n childAt(index) {\n return this.single('childAt', () => this.children().at(index));\n }\n\n /**\n * Returns a wrapper around all of the parents/ancestors of the wrapper. Does not include the node\n * in the current wrapper.\n *\n * NOTE: can only be called on a wrapper of a single node.\n *\n * @param {EnzymeSelector} [selector]\n * @returns {ShallowWrapper}\n */\n parents(selector) {\n return this.single('parents', (n) => {\n const allParents = this.wrap(nodeParents(this, n));\n return selector ? allParents.filter(selector) : allParents;\n });\n }\n\n /**\n * Returns a wrapper around the immediate parent of the current node.\n *\n * @returns {ShallowWrapper}\n */\n parent() {\n return this.flatMap((n) => [n.parents().get(0)]);\n }\n\n /**\n *\n * @param {EnzymeSelector} selector\n * @returns {ShallowWrapper}\n */\n closest(selector) {\n if (this.is(selector)) {\n return this;\n }\n const matchingAncestors = this.parents().filter(selector);\n return matchingAncestors.length > 0 ? matchingAncestors.first() : this.findWhere(() => false);\n }\n\n /**\n * Shallow renders the current node and returns a shallow wrapper around it.\n *\n * NOTE: can only be called on wrapper of a single node.\n *\n * @param {Object} options\n * @returns {ShallowWrapper}\n */\n shallow(options = {}) {\n return this.single('shallow', (n) => {\n const childOptions = makeInheritedChildOptions(this, options);\n return this.wrap(getAdapter(this[OPTIONS]).nodeToElement(n), null, childOptions);\n });\n }\n\n /**\n * Returns the value of prop with the given name of the current node.\n *\n * @param propName\n * @returns {*}\n */\n prop(propName) {\n return this.props()[propName];\n }\n\n /**\n * Used to invoke a function prop.\n * Will invoke an function prop and return its value.\n *\n * @param {String} propName\n * @returns {Any}\n */\n invoke(propName) {\n return this.single('invoke', () => {\n const handler = this.prop(propName);\n if (typeof handler !== 'function') {\n throw new TypeError('ShallowWrapper::invoke() requires the name of a prop whose value is a function');\n }\n return (...args) => {\n const response = handler(...args);\n this[ROOT].update();\n return response;\n };\n });\n }\n\n /**\n * Returns a wrapper of the node rendered by the provided render prop.\n *\n * @param {String} propName\n * @returns {Function}\n */\n renderProp(propName) {\n const adapter = getAdapter(this[OPTIONS]);\n if (typeof adapter.wrap !== 'function') {\n throw new RangeError('your adapter does not support `wrap`. Try upgrading it!');\n }\n\n return this.single('renderProp', (n) => {\n if (n.nodeType === 'host') {\n throw new TypeError('ShallowWrapper::renderProp() can only be called on custom components');\n }\n if (typeof propName !== 'string') {\n throw new TypeError('ShallowWrapper::renderProp(): `propName` must be a string');\n }\n const props = this.props();\n if (!hasOwn(props, propName)) {\n throw new Error(`ShallowWrapper::renderProp(): no prop called “${propName}“ found`);\n }\n const propValue = props[propName];\n if (typeof propValue !== 'function') {\n throw new TypeError(`ShallowWrapper::renderProp(): expected prop “${propName}“ to contain a function, but it holds “${typeof propValue}“`);\n }\n\n return (...args) => {\n const element = propValue(...args);\n const wrapped = adapter.wrap(element);\n return this.wrap(wrapped, null, this[OPTIONS]);\n };\n });\n }\n\n /**\n * Returns the key assigned to the current node.\n *\n * @returns {String}\n */\n key() {\n return this.single('key', (n) => (n.key === undefined ? null : n.key));\n }\n\n /**\n * Returns the type of the current node of this wrapper. If it's a composite component, this will\n * be the component constructor. If it's a native DOM node, it will be a string of the tag name.\n * If it's null, it will be null.\n *\n * @returns {String|Function|null}\n */\n type() {\n return this.single('type', (n) => typeOfNode(n));\n }\n\n /**\n * Returns the name of the current node of this wrapper.\n *\n * In order of precedence => type.displayName -> type.name -> type.\n *\n * @returns {String}\n */\n name() {\n const adapter = getAdapter(this[OPTIONS]);\n return this.single('name', (n) => (\n adapter.displayNameOfNode ? adapter.displayNameOfNode(n) : displayNameOfNode(n)\n ));\n }\n\n /**\n * Returns whether or not the current node has the given class name or not.\n *\n * NOTE: can only be called on a wrapper of a single node.\n *\n * @param className\n * @returns {Boolean}\n */\n hasClass(className) {\n if (typeof className === 'string' && className.indexOf('.') !== -1) {\n // eslint-disable-next-line no-console\n console.warn('It looks like you\\'re calling `ShallowWrapper::hasClass()` with a CSS selector. hasClass() expects a class name, not a CSS selector.');\n }\n return this.single('hasClass', (n) => hasClassName(n, className));\n }\n\n /**\n * Iterates through each node of the current wrapper and executes the provided function with a\n * wrapper around the corresponding node passed in as the first argument.\n *\n * @param {Function} fn\n * @returns {ShallowWrapper}\n */\n forEach(fn) {\n this.getNodesInternal().forEach((n, i) => fn.call(this, this.wrap(n), i));\n return this;\n }\n\n /**\n * Maps the current array of nodes to another array. Each node is passed in as a `ShallowWrapper`\n * to the map function.\n *\n * @param {Function} fn\n * @returns {Array}\n */\n map(fn) {\n return this.getNodesInternal().map((n, i) => fn.call(this, this.wrap(n), i));\n }\n\n /**\n * Reduces the current array of nodes to a value. Each node is passed in as a `ShallowWrapper`\n * to the reducer function.\n *\n * @param {Function} fn - the reducer function\n * @param {*} initialValue - the initial value\n * @returns {*}\n */\n reduce(fn, initialValue = undefined) {\n if (arguments.length > 1) {\n return this.getNodesInternal().reduce(\n (accum, n, i) => fn.call(this, accum, this.wrap(n), i),\n initialValue,\n );\n }\n return this.getNodesInternal().reduce((accum, n, i) => fn.call(\n this,\n i === 1 ? this.wrap(accum) : accum,\n this.wrap(n),\n i,\n ));\n }\n\n /**\n * Reduces the current array of nodes to another array, from right to left. Each node is passed\n * in as a `ShallowWrapper` to the reducer function.\n *\n * @param {Function} fn - the reducer function\n * @param {*} initialValue - the initial value\n * @returns {*}\n */\n reduceRight(fn, initialValue = undefined) {\n if (arguments.length > 1) {\n return this.getNodesInternal().reduceRight(\n (accum, n, i) => fn.call(this, accum, this.wrap(n), i),\n initialValue,\n );\n }\n return this.getNodesInternal().reduceRight((accum, n, i) => fn.call(\n this,\n i === 1 ? this.wrap(accum) : accum,\n this.wrap(n),\n i,\n ));\n }\n\n /**\n * Returns a new wrapper with a subset of the nodes of the original wrapper, according to the\n * rules of `Array#slice`.\n *\n * @param {Number} begin\n * @param {Number} end\n * @returns {ShallowWrapper}\n */\n slice(begin, end) {\n return this.wrap(this.getNodesInternal().slice(begin, end));\n }\n\n /**\n * Returns whether or not any of the nodes in the wrapper match the provided selector.\n *\n * @param {EnzymeSelector} selector\n * @returns {Boolean}\n */\n some(selector) {\n if (this[ROOT] === this) {\n throw new Error('ShallowWrapper::some() can not be called on the root');\n }\n const predicate = buildPredicate(selector);\n return this.getNodesInternal().some(predicate);\n }\n\n /**\n * Returns whether or not any of the nodes in the wrapper pass the provided predicate function.\n *\n * @param {Function} predicate\n * @returns {Boolean}\n */\n someWhere(predicate) {\n return this.getNodesInternal().some((n, i) => predicate.call(this, this.wrap(n), i));\n }\n\n /**\n * Returns whether or not all of the nodes in the wrapper match the provided selector.\n *\n * @param {EnzymeSelector} selector\n * @returns {Boolean}\n */\n every(selector) {\n const predicate = buildPredicate(selector);\n return this.getNodesInternal().every(predicate);\n }\n\n /**\n * Returns whether or not any of the nodes in the wrapper pass the provided predicate function.\n *\n * @param {Function} predicate\n * @returns {Boolean}\n */\n everyWhere(predicate) {\n return this.getNodesInternal().every((n, i) => predicate.call(this, this.wrap(n), i));\n }\n\n /**\n * Utility method used to create new wrappers with a mapping function that returns an array of\n * nodes in response to a single node wrapper. The returned wrapper is a single wrapper around\n * all of the mapped nodes flattened (and de-duplicated).\n *\n * @param {Function} fn\n * @returns {ShallowWrapper}\n */\n flatMap(fn) {\n const nodes = this.getNodesInternal().map((n, i) => fn.call(this, this.wrap(n), i));\n const flattened = flat(nodes, 1);\n return this.wrap(flattened.filter(Boolean));\n }\n\n /**\n * Finds all nodes in the current wrapper nodes' render trees that match the provided predicate\n * function. The predicate function will receive the nodes inside a ShallowWrapper as its\n * first argument.\n *\n * @param {Function} predicate\n * @returns {ShallowWrapper}\n */\n findWhere(predicate) {\n return findWhereUnwrapped(this, (n) => {\n const node = this.wrap(n);\n return node.length > 0 && predicate(node);\n });\n }\n\n /**\n * Returns the node at a given index of the current wrapper.\n *\n * @param index\n * @returns {ReactElement}\n */\n get(index) {\n return this.getElements()[index];\n }\n\n /**\n * Returns a wrapper around the node at a given index of the current wrapper.\n *\n * @param index\n * @returns {ShallowWrapper}\n */\n at(index) {\n const nodes = this.getNodesInternal();\n if (index < nodes.length) {\n return this.wrap(nodes[index]);\n }\n return this.wrap([]);\n }\n\n /**\n * Returns a wrapper around the first node of the current wrapper.\n *\n * @returns {ShallowWrapper}\n */\n first() {\n return this.at(0);\n }\n\n /**\n * Returns a wrapper around the last node of the current wrapper.\n *\n * @returns {ShallowWrapper}\n */\n last() {\n return this.at(this.length - 1);\n }\n\n /**\n * Delegates to exists()\n *\n * @returns {boolean}\n */\n isEmpty() {\n // eslint-disable-next-line no-console\n console.warn('Enzyme::Deprecated method isEmpty() called, use exists() instead.');\n return !this.exists();\n }\n\n /**\n * Returns true if the current wrapper has nodes. False otherwise.\n * If called with a selector it returns `.find(selector).exists()` instead.\n *\n * @param {EnzymeSelector} selector (optional)\n * @returns {boolean}\n */\n exists(selector = null) {\n return arguments.length > 0 ? this.find(selector).exists() : this.length > 0;\n }\n\n /**\n * Utility method that throws an error if the current instance has a length other than one.\n * This is primarily used to enforce that certain methods are only run on a wrapper when it is\n * wrapping a single node.\n *\n * @param fn\n * @returns {*}\n */\n single(name, fn) {\n const fnName = typeof name === 'string' ? name : 'unknown';\n const callback = typeof fn === 'function' ? fn : name;\n if (this.length !== 1) {\n throw new Error(`Method “${fnName}” is meant to be run on 1 node. ${this.length} found instead.`);\n }\n return callback.call(this, this.getNodeInternal());\n }\n\n /**\n * Helpful utility method to create a new wrapper with the same root as the current wrapper, with\n * any nodes passed in as the first parameter automatically wrapped.\n *\n * @param node\n * @returns {ShallowWrapper}\n */\n wrap(node, root = this[ROOT], ...args) {\n if (node instanceof ShallowWrapper) {\n return node;\n }\n return new ShallowWrapper(node, root, ...args);\n }\n\n /**\n * Returns an HTML-like string of the shallow render for debugging purposes.\n *\n * @param {Object} [options] - Property bag of additional options.\n * @param {boolean} [options.ignoreProps] - if true, props are omitted from the string.\n * @param {boolean} [options.verbose] - if true, arrays and objects to be verbosely printed.\n * @returns {String}\n */\n debug(options = {}) {\n return debugNodes(this.getNodesInternal(), options);\n }\n\n /**\n * Invokes intercepter and returns itself. intercepter is called with itself.\n * This is helpful when debugging nodes in method chains.\n * @param fn\n * @returns {ShallowWrapper}\n */\n tap(intercepter) {\n intercepter(this);\n return this;\n }\n\n /**\n * Primarily useful for HOCs (higher-order components), this method may only be\n * run on a single, non-DOM node, and will return the node, shallow-rendered.\n *\n * @param {Object} options\n * @returns {ShallowWrapper}\n */\n dive(options = {}) {\n const adapter = getAdapter(this[OPTIONS]);\n const name = 'dive';\n return this.single(name, (n) => {\n if (n && n.nodeType === 'host') {\n throw new TypeError(`ShallowWrapper::${name}() can not be called on Host Components`);\n }\n const el = getAdapter(this[OPTIONS]).nodeToElement(n);\n if (!isCustomComponentElement(el, adapter)) {\n throw new TypeError(`ShallowWrapper::${name}() can only be called on components`);\n }\n const childOptions = makeInheritedChildOptions(this, options);\n return this.wrap(el, null, childOptions);\n });\n }\n\n /**\n * Strips out all the not host-nodes from the list of nodes\n *\n * This method is useful if you want to check for the presence of host nodes\n * (actually rendered HTML elements) ignoring the React nodes.\n */\n hostNodes() {\n return this.filterWhere((n) => typeof n.type() === 'string');\n }\n}\n\n/**\n * Updates the context of the primary wrapper when the\n * `wrappingComponent` re-renders.\n */\nfunction updatePrimaryRootContext(wrappingComponent) {\n const adapter = getAdapter(wrappingComponent[OPTIONS]);\n const primaryWrapper = wrappingComponent[PRIMARY_WRAPPER];\n const primaryRenderer = primaryWrapper[RENDERER];\n const primaryNode = primaryRenderer.getNode();\n const {\n legacyContext,\n providerValues,\n } = getContextFromWrappingComponent(wrappingComponent, adapter);\n const prevProviderValues = primaryWrapper[PROVIDER_VALUES];\n\n primaryWrapper.setContext({\n ...wrappingComponent[PRIMARY_WRAPPER][OPTIONS].context,\n ...legacyContext,\n });\n primaryWrapper[PROVIDER_VALUES] = new Map([...prevProviderValues, ...providerValues]);\n\n if (typeof adapter.isContextConsumer === 'function' && adapter.isContextConsumer(primaryNode.type)) {\n const Consumer = primaryNode.type;\n // Adapters with an `isContextConsumer` method will definitely have a `getProviderFromConsumer`\n // method.\n const Provider = adapter.getProviderFromConsumer(Consumer);\n const newValue = providerValues.get(Provider);\n const oldValue = prevProviderValues.get(Provider);\n\n // Use referential comparison like React\n if (newValue !== oldValue) {\n primaryWrapper.rerender();\n }\n }\n}\n\n/**\n * A *special* \"root\" wrapper that represents the component passed as `wrappingComponent`.\n * It is linked to the primary root such that updates to it will update the primary.\n *\n * @class WrappingComponentWrapper\n */\nclass WrappingComponentWrapper extends ShallowWrapper {\n constructor(nodes, root, RootFinder) {\n super(nodes);\n privateSet(this, PRIMARY_WRAPPER, root);\n privateSet(this, ROOT_FINDER, RootFinder);\n }\n\n /**\n * Like rerender() on ShallowWrapper, except it also does a \"full render\" of\n * itself and updates the primary ShallowWrapper's context.\n */\n rerender(...args) {\n const result = super.rerender(...args);\n updatePrimaryRootContext(this);\n return result;\n }\n\n /**\n * Like setState() on ShallowWrapper, except it also does a \"full render\" of\n * itself and updates the primary ShallowWrapper's context.\n */\n setState(...args) {\n const result = super.setState(...args);\n updatePrimaryRootContext(this);\n return result;\n }\n\n // eslint-disable-next-line class-methods-use-this\n getWrappingComponent() {\n throw new Error('ShallowWrapper::getWrappingComponent() can only be called on the root');\n }\n}\n\nif (ITERATOR_SYMBOL) {\n Object.defineProperty(ShallowWrapper.prototype, ITERATOR_SYMBOL, {\n configurable: true,\n value: function iterator() {\n const iter = this.getNodesInternal()[ITERATOR_SYMBOL]();\n const adapter = getAdapter(this[OPTIONS]);\n return {\n [ITERATOR_SYMBOL]() { return this; },\n next() {\n const next = iter.next();\n if (next.done) {\n return { done: true };\n }\n return {\n done: false,\n value: adapter.nodeToElement(next.value),\n };\n },\n };\n },\n });\n}\n\nfunction privateWarning(prop, extraMessage) {\n Object.defineProperty(ShallowWrapper.prototype, prop, {\n get() {\n throw new Error(trim(`\n Attempted to access ShallowWrapper::${prop}, which was previously a private property on\n Enzyme ShallowWrapper instances, but is no longer and should not be relied upon.\n ${extraMessage}\n `));\n },\n enumerable: false,\n configurable: false,\n });\n}\n\nprivateWarning('node', 'Consider using the getElement() method instead.');\nprivateWarning('nodes', 'Consider using the getElements() method instead.');\nprivateWarning('renderer', '');\nprivateWarning('options', '');\nprivateWarning('complexSelector', '');\n\nexport default ShallowWrapper;\n" }, { "path": "packages/enzyme/src/Utils.js", "content": "/* eslint no-use-before-define: 0 */\nimport isEqual from 'lodash.isequal';\nimport is from 'object-is';\nimport entries from 'object.entries';\nimport fromEntries from 'object.fromentries';\nimport functionName from 'function.prototype.name';\nimport hasOwn from 'hasown';\nimport flat from 'array.prototype.flat';\nimport trim from 'string.prototype.trim';\nimport cheerio from 'cheerio';\nimport { isHtml } from 'cheerio/lib/utils';\n\nimport { get } from './configuration';\nimport { childrenOfNode } from './RSTTraversal';\nimport realGetAdapter from './getAdapter';\nimport validateAdapter from './validateAdapter';\n\nexport const ITERATOR_SYMBOL = typeof Symbol === 'function' && Symbol.iterator;\n\nexport function getAdapter(options = {}) {\n console.warn('getAdapter from Utils is deprecated; please use ./getAdapter instead');\n return realGetAdapter(options);\n}\n\nfunction validateMountOptions(attachTo, hydrateIn) {\n if (attachTo && hydrateIn && attachTo !== hydrateIn) {\n throw new TypeError('If both the `attachTo` and `hydrateIn` options are provided, they must be === (for backwards compatibility)');\n }\n}\n\nexport function makeOptions(options) {\n const { attachTo: configAttachTo, hydrateIn: configHydrateIn, ...config } = get();\n validateMountOptions(configAttachTo, configHydrateIn);\n\n const { attachTo, hydrateIn } = options;\n validateMountOptions(attachTo, hydrateIn);\n\n // neither present: both undefined\n // only attachTo present: attachTo set, hydrateIn undefined\n // only hydrateIn present: both set to hydrateIn\n // both present (and ===, per above): both set to hydrateIn\n const finalAttachTo = hydrateIn || configHydrateIn || configAttachTo || attachTo || undefined;\n const finalHydrateIn = hydrateIn || configHydrateIn || undefined;\n const mountTargets = {\n ...(finalAttachTo && { attachTo: finalAttachTo }),\n ...(finalHydrateIn && { hydrateIn: finalHydrateIn }),\n };\n\n return {\n ...config,\n ...options,\n ...mountTargets,\n };\n}\n\nexport function isCustomComponent(component, adapter) {\n validateAdapter(adapter);\n if (adapter.isCustomComponent) {\n return !!adapter.isCustomComponent(component);\n }\n return typeof component === 'function';\n}\n\nexport function isCustomComponentElement(inst, adapter) {\n if (adapter.isCustomComponentElement) {\n return !!adapter.isCustomComponentElement(inst);\n }\n return !!inst && adapter.isValidElement(inst) && typeof inst.type === 'function';\n}\n\nexport function propsOfNode(node) {\n const newEntries = entries((node && node.props) || {})\n .filter(([, value]) => typeof value !== 'undefined');\n return fromEntries(newEntries);\n}\n\nexport function typeOfNode(node) {\n return node ? node.type : null;\n}\n\nexport function nodeHasType(node, type) {\n if (!type || !node) return false;\n\n const adapter = realGetAdapter();\n if (adapter.displayNameOfNode) {\n const displayName = adapter.displayNameOfNode(node);\n return displayName === type;\n }\n\n if (!node.type) return false;\n if (typeof node.type === 'string') return node.type === type;\n return (\n typeof node.type === 'function' ? functionName(node.type) === type : node.type.name === type\n ) || node.type.displayName === type;\n}\n\nfunction internalChildrenCompare(a, b, lenComp, isLoose) {\n const nodeCompare = isLoose ? nodeMatches : nodeEqual;\n\n if (a === b) return true;\n if (!Array.isArray(a) && !Array.isArray(b)) {\n return nodeCompare(a, b, lenComp);\n }\n const flatA = flat(a, Infinity);\n const flatB = flat(b, Infinity);\n if (flatA.length !== flatB.length) return false;\n if (flatA.length === 0 && flatB.length === 0) return true;\n for (let i = 0; i < flatA.length; i += 1) {\n if (!nodeCompare(flatA[i], flatB[i], lenComp)) return false;\n }\n return true;\n}\n\nfunction childrenMatch(a, b, lenComp) {\n return internalChildrenCompare(a, b, lenComp, true);\n}\n\nfunction childrenEqual(a, b, lenComp) {\n return internalChildrenCompare(a, b, lenComp, false);\n}\n\nfunction removeNullaryReducer(acc, [key, value]) {\n const addition = value == null ? {} : { [key]: value };\n return { ...acc, ...addition };\n}\n\nfunction internalNodeCompare(a, b, lenComp, isLoose) {\n if (a === b) return true;\n if (!a || !b) return false;\n if (a.type !== b.type) return false;\n\n let left = propsOfNode(a);\n let right = propsOfNode(b);\n if (isLoose) {\n left = entries(left).reduce(removeNullaryReducer, {});\n right = entries(right).reduce(removeNullaryReducer, {});\n }\n\n const leftKeys = Object.keys(left);\n for (let i = 0; i < leftKeys.length; i += 1) {\n const prop = leftKeys[i];\n // we will check children later\n if (prop === 'children') {\n // continue;\n } else if (!(prop in right)) {\n return false;\n } else if (right[prop] === left[prop]) {\n // continue;\n } else if (typeof right[prop] === typeof left[prop] && typeof left[prop] === 'object') {\n if (!isEqual(left[prop], right[prop])) return false;\n } else {\n return false;\n }\n }\n\n const leftHasChildren = 'children' in left;\n const rightHasChildren = 'children' in right;\n const childCompare = isLoose ? childrenMatch : childrenEqual;\n if (leftHasChildren || rightHasChildren) {\n if (!childCompare(\n childrenToSimplifiedArray(left.children, isLoose),\n childrenToSimplifiedArray(right.children, isLoose),\n lenComp,\n )) {\n return false;\n }\n }\n\n if (!isTextualNode(a)) {\n const rightKeys = Object.keys(right);\n return lenComp(leftKeys.length - leftHasChildren, rightKeys.length - rightHasChildren);\n }\n\n return false;\n}\n\nexport function nodeMatches(a, b, lenComp = is) {\n return internalNodeCompare(a, b, lenComp, true);\n}\n\nexport function nodeEqual(a, b, lenComp = is) {\n return internalNodeCompare(a, b, lenComp, false);\n}\n\nexport function containsChildrenSubArray(match, node, subArray) {\n const children = childrenOfNode(node);\n const checker = (_, i) => arraysEqual(match, children.slice(i, i + subArray.length), subArray);\n return children.some(checker);\n}\n\nfunction arraysEqual(match, left, right) {\n return left.length === right.length && left.every((el, i) => match(el, right[i]));\n}\n\nfunction childrenToArray(children) {\n const result = [];\n\n const push = (el) => {\n if (el === null || el === false || typeof el === 'undefined') return;\n result.push(el);\n };\n\n if (Array.isArray(children)) {\n children.forEach(push);\n } else {\n push(children);\n }\n return result;\n}\n\nexport function childrenToSimplifiedArray(nodeChildren, isLoose = false) {\n const childrenArray = childrenToArray(nodeChildren);\n const simplifiedArray = [];\n\n for (let i = 0; i < childrenArray.length; i += 1) {\n const child = childrenArray[i];\n const previousChild = simplifiedArray.pop();\n\n if (typeof previousChild === 'undefined') {\n simplifiedArray.push(child);\n } else if (isTextualNode(child) && isTextualNode(previousChild)) {\n simplifiedArray.push(previousChild + child);\n } else {\n simplifiedArray.push(previousChild);\n simplifiedArray.push(child);\n }\n }\n\n if (isLoose) {\n return simplifiedArray.map((x) => (typeof x === 'string' ? trim(x) : x));\n }\n\n return simplifiedArray;\n}\n\nfunction isTextualNode(node) {\n return typeof node === 'string' || typeof node === 'number';\n}\n\nexport function isReactElementAlike(arg, adapter) {\n return adapter.isValidElement(arg) || isTextualNode(arg) || Array.isArray(arg);\n}\n\n// TODO(lmr): can we get rid of this outside of the adapter?\nexport function withSetStateAllowed(fn) {\n // NOTE(lmr):\n // this is currently here to circumvent a React bug where `setState()` is\n // not allowed without global being defined.\n let cleanup = false;\n if (typeof global.document === 'undefined') {\n cleanup = true;\n global.document = {};\n }\n fn();\n if (cleanup) {\n // This works around a bug in node/jest in that developers aren't able to\n // delete things from global when running in a node vm.\n global.document = undefined;\n delete global.document;\n }\n}\n\n// TODO, semver-major: remove this\nexport function AND(fns) {\n const fnsReversed = fns.slice().reverse();\n return (x) => fnsReversed.every((fn) => fn(x));\n}\n\nexport function displayNameOfNode(node) {\n if (!node) return null;\n\n const { type } = node;\n\n if (!type) return null;\n\n return type.displayName || (typeof type === 'function' ? functionName(type) : type.name || type);\n}\n\nexport function sym(s) {\n return typeof Symbol === 'function' ? Symbol.for(`enzyme.${s}`) : s;\n}\n\nexport function privateSet(obj, prop, value) {\n Object.defineProperty(obj, prop, {\n value,\n enumerable: false,\n writable: true,\n });\n}\n\nexport function cloneElement(adapter, el, props) {\n return adapter.createElement(\n el.type,\n { ...el.props, ...props },\n );\n}\n\nexport function spyMethod(instance, methodName, getStub = () => {}) {\n let lastReturnValue;\n const originalMethod = instance[methodName];\n const hasOwnProp = hasOwn(instance, methodName);\n let descriptor;\n if (hasOwnProp) {\n descriptor = Object.getOwnPropertyDescriptor(instance, methodName);\n }\n Object.defineProperty(instance, methodName, {\n configurable: true,\n enumerable: !descriptor || !!descriptor.enumerable,\n value: getStub(originalMethod) || function spied(...args) {\n const result = originalMethod.apply(this, args);\n lastReturnValue = result;\n return result;\n },\n });\n return {\n restore() {\n if (hasOwnProp) {\n if (descriptor) {\n Object.defineProperty(instance, methodName, descriptor);\n } else {\n /* eslint-disable no-param-reassign */\n instance[methodName] = originalMethod;\n /* eslint-enable no-param-reassign */\n }\n } else {\n /* eslint-disable no-param-reassign */\n delete instance[methodName];\n /* eslint-enable no-param-reassign */\n }\n },\n getLastReturnValue() {\n return lastReturnValue;\n },\n };\n}\n\nexport function spyProperty(instance, propertyName, handlers = {}) {\n const originalValue = instance[propertyName];\n const hasOwnProp = hasOwn(instance, propertyName);\n let descriptor;\n if (hasOwnProp) {\n descriptor = Object.getOwnPropertyDescriptor(instance, propertyName);\n }\n let wasAssigned = false;\n let holder = originalValue;\n const getV = handlers.get ? () => {\n const value = descriptor && descriptor.get ? descriptor.get.call(instance) : holder;\n return handlers.get.call(instance, value);\n } : () => holder;\n const set = handlers.set ? (newValue) => {\n wasAssigned = true;\n const handlerNewValue = handlers.set.call(instance, holder, newValue);\n holder = handlerNewValue;\n if (descriptor && descriptor.set) {\n descriptor.set.call(instance, holder);\n }\n } : (v) => {\n wasAssigned = true;\n holder = v;\n };\n Object.defineProperty(instance, propertyName, {\n configurable: true,\n enumerable: !descriptor || !!descriptor.enumerable,\n get: getV,\n set,\n });\n\n return {\n restore() {\n if (hasOwnProp) {\n if (descriptor) {\n Object.defineProperty(instance, propertyName, descriptor);\n } else {\n /* eslint-disable no-param-reassign */\n instance[propertyName] = holder;\n /* eslint-enable no-param-reassign */\n }\n } else {\n /* eslint-disable no-param-reassign */\n delete instance[propertyName];\n /* eslint-enable no-param-reassign */\n }\n },\n wasAssigned() {\n return wasAssigned;\n },\n };\n}\n\nexport { default as shallowEqual } from 'enzyme-shallow-equal';\n\nexport function isEmptyValue(renderedValue) {\n return renderedValue === null || renderedValue === false;\n}\n\nexport function renderedDive(nodes) {\n if (isEmptyValue(nodes)) {\n return true;\n }\n\n return [].concat(nodes).every((n) => {\n if (n) {\n const { rendered } = n;\n return isEmptyValue(rendered) || renderedDive(rendered);\n }\n\n return isEmptyValue(n);\n });\n}\n\nexport function loadCheerioRoot(html) {\n if (!html) {\n return cheerio.root();\n }\n\n if (!isHtml(html)) {\n // use isDocument=false to create fragment\n return cheerio.load(html, null, false).root();\n }\n\n return cheerio.load('')(html);\n}\n" }, { "path": "packages/enzyme/src/configuration.js", "content": "import validateAdapter from './validateAdapter';\n\nlet configuration = {};\n\nexport function get() {\n return { ...configuration };\n}\n\nexport function merge(extra) {\n if (extra.adapter) {\n validateAdapter(extra.adapter);\n }\n Object.assign(configuration, extra);\n}\n\nexport function reset(replacementConfig = {}) {\n configuration = {};\n merge(replacementConfig);\n}\n" }, { "path": "packages/enzyme/src/getAdapter.js", "content": "import validateAdapter from './validateAdapter';\nimport { get } from './configuration';\n\nexport default function getAdapter(options = {}) {\n if (options.adapter) {\n validateAdapter(options.adapter);\n return options.adapter;\n }\n const { adapter } = get();\n validateAdapter(adapter);\n return adapter;\n}\n" }, { "path": "packages/enzyme/src/index.js", "content": "export { default as ReactWrapper } from './ReactWrapper';\nexport { default as ShallowWrapper } from './ShallowWrapper';\nexport { default as EnzymeAdapter } from './EnzymeAdapter';\n\nexport { default as mount } from './mount';\nexport { default as shallow } from './shallow';\nexport { default as render } from './render';\nexport { merge as configure } from './configuration';\n" }, { "path": "packages/enzyme/src/mount.js", "content": "import ReactWrapper from './ReactWrapper';\n\n/**\n * Mounts and renders a react component into the document and provides a testing wrapper around it.\n *\n * @param node\n * @returns {ReactWrapper}\n */\nexport default function mount(node, options) {\n return new ReactWrapper(node, null, options);\n}\n" }, { "path": "packages/enzyme/src/render.js", "content": "import getAdapter from './getAdapter';\nimport { loadCheerioRoot } from './Utils';\n\n/**\n * Renders a react component into static HTML and provides a cheerio wrapper around it. This is\n * somewhat asymmetric with `mount` and `shallow`, which don't use any external libraries, but\n * Cheerio's API is pretty close to what we actually want and has a significant amount of utility\n * that would be recreating the wheel if we didn't use it.\n *\n * I think there are a lot of good use cases to use `render` instead of `shallow` or `mount`, and\n * thus I'd like to keep this API in here even though it's not really \"ours\".\n *\n * @param node\n * @param options\n * @returns {Cheerio}\n */\n\nexport default function render(node, options = {}) {\n const adapter = getAdapter(options);\n const renderer = adapter.createRenderer({ mode: 'string', ...options });\n const html = renderer.render(node, options.context);\n return loadCheerioRoot(html);\n}\n" }, { "path": "packages/enzyme/src/selectors.js", "content": "import { createParser } from 'rst-selector-parser';\nimport values from 'object.values';\nimport flat from 'array.prototype.flat';\nimport is from 'object-is';\nimport hasOwn from 'hasown';\nimport elementsByConstructor from 'html-element-map/byConstructor';\nimport {\n treeFilter,\n nodeHasId,\n findParentNode,\n nodeMatchesObjectProps,\n childrenOfNode,\n hasClassName,\n} from './RSTTraversal';\nimport { nodeHasType, propsOfNode } from './Utils';\nimport getAdapter from './getAdapter';\n// our CSS selector parser instance\nconst parser = createParser();\n\n// Combinators that allow you to chance selectors\nconst CHILD = 'childCombinator';\nconst ADJACENT_SIBLING = 'adjacentSiblingCombinator';\nconst GENERAL_SIBLING = 'generalSiblingCombinator';\nconst DESCENDANT = 'descendantCombinator';\n\n// Selectors for targeting elements\nconst SELECTOR = 'selector';\nconst TYPE_SELECTOR = 'typeSelector';\nconst CLASS_SELECTOR = 'classSelector';\nconst ID_SELECTOR = 'idSelector';\nconst UNIVERSAL_SELECTOR = 'universalSelector';\nconst ATTRIBUTE_PRESENCE = 'attributePresenceSelector';\nconst ATTRIBUTE_VALUE = 'attributeValueSelector';\n// @TODO we dont support these, throw if they are used\nconst PSEUDO_CLASS = 'pseudoClassSelector';\nconst PSEUDO_ELEMENT = 'pseudoElementSelector';\n\nconst EXACT_ATTRIBUTE_OPERATOR = '=';\nconst WHITELIST_ATTRIBUTE_OPERATOR = '~=';\nconst HYPHENATED_ATTRIBUTE_OPERATOR = '|=';\nconst PREFIX_ATTRIBUTE_OPERATOR = '^=';\nconst SUFFIX_ATTRIBUTE_OPERATOR = '$=';\nconst SUBSTRING_ATTRIBUTE_OPERATOR = '*=';\n\nfunction unique(arr) {\n return [...new Set(arr)];\n}\n\n/**\n * Calls reduce on a array of nodes with the passed\n * function, returning only unique results.\n * @param {Function} fn\n * @param {Array} nodes\n */\nfunction uniqueReduce(fn, nodes) {\n return unique(nodes.reduce(fn, []));\n}\n\n/**\n * Takes a CSS selector and returns a set of tokens parsed\n * by scalpel.\n * @param {String} selector\n */\nfunction safelyGenerateTokens(selector) {\n try {\n return parser.parse(selector);\n } catch (err) {\n throw new Error(`Failed to parse selector: ${selector}`);\n }\n}\n\nfunction matchAttributeSelector(node, token) {\n const { operator, value, name } = token;\n const nodeProps = propsOfNode(node);\n const descriptor = Object.getOwnPropertyDescriptor(nodeProps, name);\n if (descriptor && descriptor.get) {\n return false;\n }\n const nodePropValue = nodeProps[name];\n if (typeof nodePropValue === 'undefined') {\n return false;\n }\n if (token.type === ATTRIBUTE_PRESENCE) {\n return hasOwn(nodeProps, token.name);\n }\n // Only the exact value operator (\"=\") can match non-strings\n if (typeof nodePropValue !== 'string' || typeof value !== 'string') {\n if (operator !== EXACT_ATTRIBUTE_OPERATOR) {\n return false;\n }\n }\n switch (operator) {\n /**\n * Represents an element with the att attribute whose value is exactly \"val\".\n * @example\n * [attr=\"val\"] matches attr=\"val\"\n */\n case EXACT_ATTRIBUTE_OPERATOR:\n return is(nodePropValue, value);\n /**\n * Represents an element with the att attribute whose value is a whitespace-separated\n * list of words, one of which is exactly\n * @example\n * [rel~=\"copyright\"] matches rel=\"copyright other\"\n */\n case WHITELIST_ATTRIBUTE_OPERATOR:\n return nodePropValue.split(' ').indexOf(value) !== -1;\n /**\n * Represents an element with the att attribute, its value either being exactly the\n * value or beginning with the value immediately followed by \"-\"\n * @example\n * [hreflang|=\"en\"] matches hreflang=\"en-US\"\n */\n case HYPHENATED_ATTRIBUTE_OPERATOR:\n return nodePropValue === value || nodePropValue.startsWith(`${value}-`);\n /**\n * Represents an element with the att attribute whose value begins with the prefix value.\n * If the value is the empty string then the selector does not represent anything.\n * @example\n * [type^=\"image\"] matches type=\"imageobject\"\n */\n case PREFIX_ATTRIBUTE_OPERATOR:\n return value === '' ? false : nodePropValue.slice(0, value.length) === value;\n /**\n * Represents an element with the att attribute whose value ends with the suffix value.\n * If the value is the empty string then the selector does not represent anything.\n * @example\n * [type$=\"image\"] matches type=\"imageobject\"\n */\n case SUFFIX_ATTRIBUTE_OPERATOR:\n return value === '' ? false : nodePropValue.slice(-value.length) === value;\n /**\n * Represents an element with the att attribute whose value contains at least one\n * instance of the value. If value is the empty string then the\n * selector does not represent anything.\n * @example\n * [title*=\"hello\"] matches title=\"well hello there\"\n */\n case SUBSTRING_ATTRIBUTE_OPERATOR:\n return value === '' ? false : nodePropValue.indexOf(value) !== -1;\n default:\n throw new Error(`Enzyme::Selector: Unknown attribute selector operator \"${operator}\"`);\n }\n}\n\nfunction matchPseudoSelector(node, token, root) {\n const { name, parameters } = token;\n if (name === 'not') {\n // eslint-disable-next-line no-use-before-define\n return parameters.every((selector) => reduceTreeBySelector(selector, node).length === 0);\n }\n if (name === 'empty') {\n return treeFilter(node, (n) => n !== node).length === 0;\n }\n if (name === 'first-child') {\n const { rendered } = findParentNode(root, node);\n const [firstChild] = rendered;\n return firstChild === node;\n }\n if (name === 'last-child') {\n const { rendered } = findParentNode(root, node);\n return rendered[rendered.length - 1] === node;\n }\n if (name === 'focus') {\n if (typeof document === 'undefined') {\n throw new Error('Enzyme::Selector does not support the \":focus\" pseudo-element without a global `document`.');\n }\n const adapter = getAdapter();\n /* eslint-env browser */\n return document.activeElement && adapter.nodeToHostNode(node) === document.activeElement;\n }\n\n throw new TypeError(`Enzyme::Selector does not support the \"${token.name}\" pseudo-element or pseudo-class selectors.`);\n}\n\n/**\n * Takes a node and a token and determines if the node\n * matches the predicate defined by the token.\n * @param {Node} node\n * @param {Token} token\n */\nfunction nodeMatchesToken(node, token, root) {\n if (node === null || typeof node === 'string') {\n return false;\n }\n switch (token.type) {\n /**\n * Match every node\n * @example '*' matches every node\n */\n case UNIVERSAL_SELECTOR:\n return true;\n /**\n * Match against the className prop\n * @example '.active' matches
\n */\n case CLASS_SELECTOR:\n return hasClassName(node, token.name);\n /**\n * Simple type matching\n * @example 'div' matches
\n */\n case TYPE_SELECTOR:\n return nodeHasType(node, token.name);\n /**\n * Match against the `id` prop\n * @example '#nav' matches