Circle V2 API Docs
    Preparing search index...

    Interface HydrateOptions<Q, Container, BaseElement>

    interface HydrateOptions<
        Q extends Queries,
        Container extends HydrateableContainer,
        BaseElement extends HydrateableContainer = Container,
    > {
        baseElement?: BaseElement;
        container?: Container;
        hydrate: true;
        legacyRoot?: boolean;
        onCaughtError?: (
            error: unknown,
            errorInfo: {
                componentStack?: string;
                errorBoundary?: Component<unknown, {}, any>;
            },
        ) => void;
        onRecoverableError?: (error: unknown, errorInfo: ErrorInfo) => void;
        onUncaughtError?: undefined;
        queries?: Q;
        reactStrictMode?: boolean;
        wrapper?: JSXElementConstructor<{ children: ReactNode }>;
    }

    Type Parameters

    • Q extends Queries
    • Container extends HydrateableContainer
    • BaseElement extends HydrateableContainer = Container

    Hierarchy (View Summary)

    Index

    Properties

    baseElement?: BaseElement

    Defaults to the container if the container is specified. Otherwise document.body is used for the default. This is used as the base element for the queries as well as what is printed when you use debug().

    container?: Container

    By default, React Testing Library will create a div and append that div to the document.body. Your React component will be rendered in the created div. If you provide your own HTMLElement container via this option, it will not be appended to the document.body automatically.

    For example: If you are unit testing a <tbody> element, it cannot be a child of a div. In this case, you can specify a table as the render container.

    hydrate: true

    If hydrate is set to true, then it will render with ReactDOM.hydrate. This may be useful if you are using server-side rendering and use ReactDOM.hydrate to mount your components.

    legacyRoot?: boolean

    Only works if used with React 18. Set to true if you want to force synchronous ReactDOM.render. Otherwise render will default to concurrent React if available.

    onCaughtError?: (
        error: unknown,
        errorInfo: {
            componentStack?: string;
            errorBoundary?: Component<unknown, {}, any>;
        },
    ) => void

    Only supported in React 19. Callback called when React catches an error in an Error Boundary. Called with the error caught by the Error Boundary, and an errorInfo object containing the componentStack.

    onRecoverableError?: (error: unknown, errorInfo: ErrorInfo) => void

    Callback called when React automatically recovers from errors. Called with an error React throws, and an errorInfo object containing the componentStack. Some recoverable errors may include the original error cause as error.cause.

    onUncaughtError?: undefined

    Not supported at the moment

    queries?: Q

    Queries to bind. Overrides the default set from DOM Testing Library unless merged.

    reactStrictMode?: boolean

    When enabled, is rendered around the inner element. If defined, overrides the value of reactStrictMode set in configure.

    wrapper?: JSXElementConstructor<{ children: ReactNode }>

    Pass a React Component as the wrapper option to have it rendered around the inner element. This is most useful for creating reusable custom render functions for common data providers. See setup for examples.