Update dependency pleasantest to v3

[renovate[bot]]

This PR contains the following updates:

Package	Change	Age	Adoption	Passing	Confidence
pleasantest	2.2.0 -> 3.0.0

---

Release Notes

cloudfour/pleasantest

v3.0.0

Compare Source

Major Changes

• #​561 b565e0b Thanks @​calebeby! - Normalize whitespace in element accessible names in getAccessibilityTree. Markup with elements which have an accessible name that includes irregular whitespace, like non-breaking spaces, will now have a different output for getAccessibilityTree snapshots. Previously, the whitespace was included, now, whitespace is replaced with a single space.

• #​535 dc6f81c Thanks @​calebeby! - Values exported from runJS are now available in Node.

  For example:

  test(
    'receiving exported values from runJS',
    withBrowser(async ({ utils }) => {
      // Each export is available in the returned object.
      // Each export is wrapped in a JSHandle, meaning that it points to an in-browser object
      const { focusTarget, favoriteNumber } = await utils.runJS(`
        export const focusTarget = document.activeElement
        export const favoriteNumber = 20
      `);
  
      // Serializable JSHandles can be unwrapped using JSONValue:
      console.log(await favoriteNumber.jsonValue()); // Logs "20"
  
      // A JSHandle<Element>, or ElementHandle is not serializable
      // But we can pass it back into the browser to use it (it will be unwrapped in the browser):
  
      await utils.runJS(
        `
        // The import.meta.pleasantestArgs context object receives the parameters passed in below
        const [focusTarget] = import.meta.pleasantestArgs;
        console.log(focusTarget) // Logs the element in the browser
        `,
        // Passing the JSHandle in here passes it into the browser (unwrapped) in import.meta.pleasantestArgs
        [focusTarget],
      );
    }),
  );
  

  We've also introduced a utility function to make it easier to call JSHandles that point to functions, makeCallableJSHandle. This function takes a JSHandle<Function> and returns a node function that calls the corresponding browser function, passing along the parameters, and returning the return value wrapped in Promise<JSHandle<T>>:

  // new import:
  import { makeCallableJSHandle } from 'pleasantest';
  
  test(
    'calling functions with makeCallableJSHandle',
    withBrowser(async ({ utils }) => {
      const { displayFavoriteNumber } = await utils.runJS(`
        export const displayFavoriteNumber = (number) => {
          document.querySelector('.output').innerHTML = "Favorite number is: " + number
        }
      `);
  
      // displayFavoriteNumber is a JSHandle<Function>
      // (a pointer to a function in the browser)
      // so we cannot call it directly, so we wrap it in a node function first:
  
      const displayFavoriteNumberNode = makeCallableJSHandle(
        displayFavoriteNumber,
      );
  
      // Note the added `await`.
      // Even though the original function was not async, the wrapped function is.
      // This is needed because the wrapped function needs to asynchronously communicate with the browser.
      await displayFavoriteNumberNode(42);
    }),
  );
  

  For TypeScript users, runJS now accepts a new optional type parameter, to specify the exported types of the in-browser module that is passed in. The default value for this parameter is Record<string, unknown> (an object with string properties and unknown values). Note that this type does not include JSHandles, those are wrapped in the return type from runJS automatically.

  Using the first example, the optional type would be:

  test(
    'receiving exported values from runJS',
    withBrowser(async ({ utils }) => {
      const { focusTarget, favoriteNumber } = await utils.runJS<{
        focusTarget: Element;
        favoriteNumber: number;
      }>(`
        export const focusTarget = document.activeElement
        export const favoriteNumber = 20
      `);
    }),
  );
  

  Now focusTarget automatically has the type JSHandle<Element> and favoriteNumber automatically has the type JSHandle<number>. Without passing in the type parameter to runJS, their types would both be JSHandle<unknown>.

• #​541 39085ac Thanks @​calebeby! - injectHTML now executes script tags in the injected markup by default. This can be disabled by passing the executeScriptTags: false option as the second parameter.

  For example, the script tag is now executed by default:

  await utils.injectHTML(
    "<script>document.querySelector('div').textContent = 'changed'</script>",
  );
  

  But by passing executeScriptTags: false, we can disable execution:

  await utils.injectHTML(
    "<script>document.querySelector('div').textContent = 'changed'</script>",
    { executeScriptTags: false },
  );
  

• #​535 dc6f81c Thanks @​calebeby! - The way that runJS receives parameters in the browser has changed. Now, parameters are available as import.meta.pleasantestArgs instead of through an automatically-called default export.

  For example, code that used to work like this:

  test(
    'old version of runJS parameters',
    withBrowser(async ({ utils }) => {
      // Pass a variable from node to the browser
      const url = isDev ? 'dev.example.com' : 'prod.example.com';
  
      await utils.runJS(
        `
        // Parameters get passed into the default-export function, which is called automatically
        export default (url) => {
          console.log(url)
        }
        `,
        // array of parameters passed here
        [url],
      );
    }),
  );
  

  Now should be written like this:

  test(
    'new version of runJS parameters',
    withBrowser(async ({ utils }) => {
      // Pass a variable from node to the browser
      const url = isDev ? 'dev.example.com' : 'prod.example.com';
  
      await utils.runJS(
        `
        // Parameters get passed as an array into this context variable, and we can destructure them
        const [url] = import.meta.pleasantestArgs
        console.log(url)
        // If we added a default exported function here, it would no longer be automatically called.
        `,
        // array of parameters passed here
        [url],
      );
    }),
  );
  

  This is a breaking change, because the previous mechanism for receiving parameters no longer works, and functions that are default exports from runJS are no longer called automatically.

• #​506 7592994 Thanks @​calebeby! - Drop support for Node 12 and 17

Minor Changes

• #​557 7bb10e0 Thanks @​calebeby! - Update @testing-library/dom to 8.17.1 and @testing-library/jest-dom to 5.16.5

---

Configuration

📅 Schedule: Branch creation - "before 9am on monday" (UTC), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• [ ] If you want to rebase/retry this PR, check this box

---

This PR has been generated by Mend Renovate. View repository job log here.

[changeset-bot[bot]]

⚠️ No Changeset found

Latest commit: baf6799be57518712bef18fab2196182926b01c2

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[netlify[bot]]

✅ Deploy Preview for cloudfour-patterns ready!

Name	Link
🔨 Latest commit	baf6799be57518712bef18fab2196182926b01c2
🔍 Latest deploy log	https://app.netlify.com/sites/cloudfour-patterns/deploys/63da8fa8b32960000925d93d
😎 Deploy Preview	https://deploy-preview-2038--cloudfour-patterns.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site settings.

[tylersticka]

I thought this would be simple matter of updating the useJS examples in the repository to satisfy the breaking change in 3.x.x, but even with that change there are a bunch of TypeScript errors and breaking tests. Definitely going to need a developer to dive deeper into this.

[renovate[bot]]

Edited/Blocked Notification

Renovate will not automatically rebase this PR, because it does not recognize the last commit author and assumes somebody else may have edited the PR. You can manually request rebase by checking the rebase/retry box above.

⚠ Warning: custom changes will be lost.