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

Package to support React 18 #654

Closed
snowystinger opened this issue Jul 21, 2021 · 18 comments
Closed

Package to support React 18 #654

snowystinger opened this issue Jul 21, 2021 · 18 comments
Labels
enhancement New feature or request

Comments

@snowystinger
Copy link
Contributor

Describe the feature you'd like:

React 18 alpha is out, our library is starting to determine what we'll need to do to support it. We use this library for tests and I don't see an issue for it already nor do I see a PR for it.

Suggested implementation:

I think just changing over to create is most of the work reactwg/react-18#5
I don't know if this would need the work that Testing Library is doing as well for concurrent mode, I don't know enough about how that works with this. testing-library/react-testing-library#937

@snowystinger snowystinger added the enhancement New feature or request label Jul 21, 2021
@mpeyper
Copy link
Member

mpeyper commented Jul 23, 2021

We did have #217 raised at one point but to be honest I'm not sure how much we'll need to do for concurrent mode as we already support suspense so, and my naive understanding of how it all fits together may be showing here, if we can support rendering with ReactDOM. createRoot instead of ReactDOM.render, then it should be all that's needed?

I think we should continue any discussions in #655 than here so we can see where the issues are when the code is updated.

@smmoosavi
Copy link

I need to confirm my lib works properly with strict effects. Right now, only @testing-library/react@alpha supports it.

// pass
import { act, render } from '@testing-library/react'; // @testing-library/[email protected]
import { StrictMode, useEffect } from 'react';

const Foo = (props: { log: () => void; effect: () => void; clean: () => void }) => {
  props.log();
  useEffect(() => {
    props.effect();
    return props.clean;
  });
  return null;
};

describe('test renderer', function () {
  it('should be in strict mode', function () {
    const fn = jest.fn();
    const effect = jest.fn();
    const clean = jest.fn();
    const {unmount} = render(
      <StrictMode>
        <Foo log={fn} effect={effect} clean={clean}/>
      </StrictMode>,
    );
      expect(fn).toHaveBeenCalledTimes(2);
      expect(effect).toHaveBeenCalledTimes(2);
      expect(clean).toHaveBeenCalledTimes(1);
      act(() => {
          unmount();
      });
      expect(clean).toHaveBeenCalledTimes(2);
  });
});
import { act, renderHook } from '@testing-library/react-hooks'; // @7.0.2 or @8.0.0-alpha.1
import React, { StrictMode, useEffect } from 'react';

describe('test renderer', function () {
  it('should be in strict mode', function () {
    const fn = jest.fn();
    const effect = jest.fn();
    const clean = jest.fn();
    const { unmount } = renderHook(
      () => {
        fn();
        useEffect(() => {
          effect();
          return clean;
        });
      },
      { wrapper: StrictMode },
    );
    expect(fn).toHaveBeenCalledTimes(2);
    expect(effect).toHaveBeenCalledTimes(2); // fail: Received number of calls: 1
    expect(clean).toHaveBeenCalledTimes(1);
    act(() => {
      unmount();
    });
    expect(clean).toHaveBeenCalledTimes(2);
  });
});

@mpeyper
Copy link
Member

mpeyper commented Feb 13, 2022

Hi @smmoosavi,

@testing-library/react@alpha should have it's own renderHook export now that supports react 18 features. Please try it out but let us know if there are any issues.

@smmoosavi
Copy link

smmoosavi commented Feb 13, 2022

Hi,
The testing-library/react-testing-library#991 is not merged yet, so I created my own renderHook inside my lib until merge of 991.

It enables strict mode by default and has better typescript types.

@jonkoops
Copy link
Contributor

React 18 has now officially been released: https://reactjs.org/blog/2022/03/29/react-v18.html

@simoneb
Copy link

simoneb commented Apr 12, 2022

Now that react 18 is out this package doesn't work any longer because of peer dependencies supporting react 17 as the latest.

There's #655 still open, suggesting that with react 18 out, RTL should have already had a renderHook function available, but this doesn't seem to be the case. See testing-library/react-testing-library#991.

How are people handling this?

@mpeyper
Copy link
Member

mpeyper commented Apr 12, 2022

Hey @simoneb,

I’ve closed that PR now to help remove the confusion about what we are doing. The official position of this library is that we are expecting the RTL and RNTL to take over the renderHook API, but you are correct, neither have actually merged their PRs yet. I know RNTL is waiting for RTL to merge theirs first, but I’m not sure what is holding up RTL from moving forward with it (considering how adamant they were that it was going to be the path forward).

As for how to handle this, I’d suggest currently the only option, if waiting is unacceptable, is to copy the implementation in the RTL PR into your project and use that until the official version is released. It’s a very thin layer over RTL so there would be very little risk of incompatibilities or massive API changes making moving over after release difficult.

function renderHook(renderCallback, options = {}) {
  const {initialProps, wrapper} = options
  const result = React.createRef()

  function TestComponent({renderCallbackProps}) {
    const pendingResult = renderCallback(renderCallbackProps)

    React.useEffect(() => {
      result.current = pendingResult
    })

    return null
  }

  const {rerender: baseRerender, unmount} = render(
    <TestComponent renderCallbackProps={initialProps} />,
    {wrapper},
  )

  function rerender(rerenderCallbackProps) {
    return baseRerender(
      <TestComponent renderCallbackProps={rerenderCallbackProps} />,
    )
  }

  return {result, rerender, unmount}
}

I do understand that this is less than ideal, but I appreciate everyone’s patience as we make this transition.

@simoneb
Copy link

simoneb commented Apr 13, 2022

@mpeyper thanks for the detailed answer!

@mpeyper
Copy link
Member

mpeyper commented Apr 15, 2022

The release of @testing-library/react version 13.1.0 includes the renderHook API. Please migrate to that for React 18 support now if you are testing for react-dom.

@ahummel25
Copy link

Any chance the RenderHookResult type is in there? This is a helpful type that gets exported in @testing-library/react-hooks. I don't see it exported in @testing-library/react.

@mpeyper
Copy link
Member

mpeyper commented Apr 15, 2022

@ahummel25 this one?

@ahummel25
Copy link

ahummel25 commented Apr 15, 2022

@mpeyper Correct. It's not exported and it looks to be an altogether different type (interface) than this one.

@mpeyper
Copy link
Member

mpeyper commented Apr 15, 2022

Ah yes, I missed that detail. Please open an issue in RTL and consider making a PR to resolve it.

As for type vs interface, it’s likely that using interface is more consistent with their type defs. If the difference is problematic for you, please add that detail to the issue/PR.

@kai-dorschner-twinsity
Copy link

My current problem is that the renderHook from @testing-library/react is not supporting the waitForNextUpdate method I require. Is there any help on that?

@joshuaellis
Copy link
Member

My current problem is that the renderHook from @testing-library/react is not supporting the waitForNextUpdate method I require. Is there any help on that?

You'd have to take it up with @testing-library/react but we tried to in the initial implementation, this was the response testing-library/react-testing-library#991 (comment)

@drianoaz
Copy link

drianoaz commented May 5, 2022

Guys,

Are there any plans for support the renderHook into Server-Side Rendering? 🥺

@joshuaellis
Copy link
Member

Guys,

Are there any plans for support the renderHook into Server-Side Rendering? 🥺

@drianoaz this should be asked in a new issue please, this is not relate to react-18.

Infact, I'm going to lock this issue, if you want to see the discussion with RTL then here's the PR – testing-library/react-testing-library#991 this is the direction that the library is going in (as seen on the README).

Any issues related to anything else should be a new one please.

@testing-library testing-library locked as too heated and limited conversation to collaborators May 5, 2022
@joshuaellis
Copy link
Member

@joshuaellis joshuaellis closed this as not planned Won't fix, can't repro, duplicate, stale Nov 4, 2024
@joshuaellis joshuaellis pinned this issue Nov 4, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

9 participants