Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix(mock-doc): overwrite parentElement in MockHTMLElement to return null #5336

Merged
merged 12 commits into from
Feb 8, 2024

Conversation

christian-bromann
Copy link
Member

@christian-bromann christian-bromann commented Feb 7, 2024

What is the current behavior?

MockHTMLElement returns MockDocument when accessing parentElement.

fixes #5252
STENCIL-1104

What is the new behavior?

Accessing parentElement in from the <html /> node always returns null as defined by the spec.

According to the spec:

A node’s parent of type Element is known as its parent element. If the node has a parent of a different type, its parent element is null.

The HTML document is not considered to be an element.

Documentation

Does this introduce a breaking change?

  • Yes
  • No

Testing

Added a simple unit test for this. I also created a reproducible example based on the original issue:

  • git clone git@github.com:christian-bromann/getbyrole-repro.git
  • cd getbyrole-repro
  • npm install
  • npm test

The test will pass. The project uses a Stencil dev build 4.12.1-dev.1707312078.2f2e3e3 based on this PR.

Other information

n/a

Copy link
Contributor

github-actions bot commented Feb 7, 2024

--strictNullChecks error report

Typechecking with --strictNullChecks resulted in 1207 errors on this branch.

That's the same number of errors on main, so at least we're not creating new ones!

reports and statistics

Our most error-prone files
Path Error Count
src/dev-server/index.ts 37
src/mock-doc/serialize-node.ts 36
src/dev-server/server-process.ts 32
src/compiler/prerender/prerender-main.ts 22
src/testing/puppeteer/puppeteer-element.ts 22
src/runtime/client-hydrate.ts 20
src/screenshot/connector-base.ts 19
src/runtime/vdom/vdom-render.ts 17
src/compiler/config/test/validate-paths.spec.ts 16
src/dev-server/request-handler.ts 15
src/compiler/prerender/prerender-optimize.ts 14
src/compiler/sys/stencil-sys.ts 14
src/compiler/transpile/transpile-module.ts 14
src/sys/node/node-sys.ts 14
src/compiler/prerender/prerender-queue.ts 13
src/compiler/sys/in-memory-fs.ts 13
src/runtime/connected-callback.ts 13
src/runtime/set-value.ts 13
src/compiler/output-targets/output-www.ts 12
src/compiler/transformers/test/parse-vdom.spec.ts 12
Our most common errors
Typescript Error Code Count
TS2345 366
TS2322 362
TS18048 224
TS18047 99
TS2722 37
TS2532 26
TS2531 23
TS2454 14
TS2790 11
TS2352 10
TS2769 8
TS2538 8
TS2344 6
TS2416 6
TS2493 3
TS18046 2
TS2684 1
TS2430 1

Unused exports report

There are 14 unused exports on this PR. That's the same number of errors on main, so at least we're not creating new ones!

Unused exports
File Line Identifier
src/runtime/bootstrap-lazy.ts 21 setNonce
src/screenshot/screenshot-fs.ts 18 readScreenshotData
src/testing/testing-utils.ts 198 withSilentWarn
src/utils/index.ts 145 CUSTOM
src/utils/index.ts 269 normalize
src/utils/index.ts 7 escapeRegExpSpecialCharacters
src/compiler/app-core/app-data.ts 25 BUILD
src/compiler/app-core/app-data.ts 115 Env
src/compiler/app-core/app-data.ts 117 NAMESPACE
src/compiler/fs-watch/fs-watch-rebuild.ts 123 updateCacheFromRebuild
src/compiler/types/validate-primary-package-output-target.ts 61 satisfies
src/compiler/types/validate-primary-package-output-target.ts 61 Record
src/testing/puppeteer/puppeteer-declarations.ts 485 WaitForEventOptions
src/compiler/sys/fetch/write-fetch-success.ts 7 writeFetchSuccessSync

Copy link
Contributor

github-actions bot commented Feb 7, 2024

PR built and packed!

Download the tarball here: https://github.com/ionic-team/stencil/actions/runs/7835829975/artifacts/1231522755

If your browser saves files to ~/Downloads you can install it like so:

npm install ~/Downloads/stencil-core-4.12.1-dev.1707425649.9dfaf34.tgz

Copy link
Member

@rwaskiewicz rwaskiewicz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are there any instructions for verifying this against the reproduction case?

I installed a locally built tarball in the repro and got:

npm t

> testing-library-test@0.0.1 test
> stencil test --spec

[19:31.2]  @stencil/core
[19:31.4]  [LOCAL DEV] v4.12.1-dev.1707311711.2f2e3e3 😸
[19:31.4]  testing spec files
[19:31.4]  jest args: --spec --max-workers=8
 FAIL  src/components/my-component/my-component.spec.ts
  my-component
    ✕ renders (8 ms)

  ● my-component › renders

    TypeError: Right-hand side of 'instanceof' is not an object

      14 |     const button = getByRole(root, 'button');
      15 |
    > 16 |     expect(button).toBeInTheDocument();
         |                    ^
      17 |   });
      18 |
      19 | });

      at checkHtmlElement (node_modules/@testing-library/jest-dom/dist/matchers-57b266e9.js:85:19)
      at Object.toBeInTheDocument (node_modules/@testing-library/jest-dom/dist/matchers-57b266e9.js:274:5)
      at __EXTERNAL_MATCHER_TRAP__ (node_modules/expect/build/index.js:325:30)
      at Object.throwingMatcher [as toBeInTheDocument] (node_modules/expect/build/index.js:326:15)
      at Object.<anonymous> (src/components/my-component/my-component.spec.ts:16:20)

Test Suites: 1 failed, 1 total
Tests:       1 failed, 1 total
Snapshots:   0 total
Time:        0.425 s, estimated 1 s
Ran all test suites.

This insinuates there's some issue pulling in that toBeInTheDocument, rather than an issue with the fix here - curious if you're seeing that as well

src/mock-doc/test/event.spec.ts Outdated Show resolved Hide resolved
@christian-bromann
Copy link
Member Author

This insinuates there's some issue pulling in that toBeInTheDocument, rather than an issue with the fix here - curious if you're seeing that as well

I haven't. I pushed a reproducible example and added some instructions to run it in the PR description.

@rwaskiewicz
Copy link
Member

rwaskiewicz commented Feb 7, 2024

That works for me - I modified your repro ever so slightly to align with the original one:

diff --git a/src/components/my-component/my-component.spec.ts b/src/components/my-component/my-component.spec.ts
index f846ab7..76dc898 100644
--- a/src/components/my-component/my-component.spec.ts
+++ b/src/components/my-component/my-component.spec.ts
@@ -1,16 +1,16 @@
 import { newSpecPage } from '@stencil/core/testing';
-import { screen } from '@testing-library/dom';
+import { getByRole } from '@testing-library/dom';
 
 import '@testing-library/jest-dom';
 import { TestComponent } from './my-component';
 
 describe('test component', () => {
   it('can find button using getByRole', async () => {
-    await newSpecPage({
+    const {root} = await newSpecPage({
       components: [TestComponent],
       html: `<test-component/>`,
     });
-    const button = screen.getByRole('button');
+    const button = getByRole(root,'button');
     expect(button).toEqualHtml('<button>test</button>');
   });
 });

and this works as expected. If there's a separate issue with using the aforementioned matcher with Stencil, we should open a new issue. Until then, I'm good to approve this. Whoops - didn't realize there were still outstanding comments

Copy link
Member

@tanner-reits tanner-reits left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just blocking for those couple tests

src/mock-doc/test/event.spec.ts Outdated Show resolved Hide resolved
@christian-bromann
Copy link
Member Author

@rwaskiewicz @tanner-reits thanks for the review, I was able to revert all test changes with some further updates on the event handler.

Copy link
Member

@rwaskiewicz rwaskiewicz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM/works as expected on Christian's repro

@christian-bromann christian-bromann added this pull request to the merge queue Feb 8, 2024
Merged via the queue into main with commit 0d9ed22 Feb 8, 2024
121 checks passed
@christian-bromann christian-bromann deleted the cb/html-parentElement branch February 8, 2024 22:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

bug: Error when using testing-library/dom getByRole
3 participants