act は、アサーションを行う前に保留中の React の更新を適用するために用いるテストヘルパです。
await act(async actFn)コンポーネントをアサーションが行える状態にまでもっていくために、レンダーや更新を行うコードを await act() の呼び出し内にラップします。これにより、テストがブラウザでの React の動作に近づきます。
リファレンス
await act(async actFn)
UI テストを書く際、レンダー、ユーザイベント、データフェッチなどのタスクは、ユーザインターフェースにおける「操作単位 (unit of interaction)」と捉えることができます。React は act() というヘルパを提供しており、これによりこれらの「操作単位」に関連するすべての更新が処理されて DOM に適用された後に、アサーションを行えるようになります。
act という名前は Arrange-Act-Assert パターンに由来します。
it ('renders with button disabled', async () => {
await act(async () => {
root.render(<TestComponent />)
});
expect(container.querySelector('button')).toBeDisabled();
});引数
async actFn: テスト対象のコンポーネントのレンダーやユーザ操作をラップする非同期関数。actFn内でトリガされた更新は内部の act キューに追加され、その後まとめてフラッシュされて DOM に変更が適用されます。非同期であるため、React は非同期境界を越えるコードも実行し、スケジュールされた更新をフラッシュします。
返り値
act は何も返しません。
使用法
コンポーネントをテストする際に act を使用して、コンポーネントの出力についてアサーションを行うことができます。
例えば以下のような Counter コンポーネントがあるとしましょう。後で挙げる使用例は、これをテストする方法を示しています。
function Counter() {
const [count, setCount] = useState(0);
const handleClick = () => {
setCount(prev => prev + 1);
}
useEffect(() => {
document.title = `You clicked ${count} times`;
}, [count]);
return (
<div>
<p>You clicked {count} times</p>
<button onClick={handleClick}>
Click me
</button>
</div>
)
}テスト内でコンポーネントをレンダーする
コンポーネントのレンダー出力内容をテストするには、レンダーを act() 内にラップします。
import {act} from 'react';
import ReactDOMClient from 'react-dom/client';
import Counter from './Counter';
it('can render and update a counter', async () => {
container = document.createElement('div');
document.body.appendChild(container);
// ✅ Render the component inside act().
await act(() => {
ReactDOMClient.createRoot(container).render(<Counter />);
});
const button = container.querySelector('button');
const label = container.querySelector('p');
expect(label.textContent).toBe('You clicked 0 times');
expect(document.title).toBe('You clicked 0 times');
});ここではコンテナを作成し、それをドキュメントに追加し、Counter コンポーネントを act() 内でレンダーします。これにより、コンポーネントのレンダーとエフェクトの適用が終わってからアサーションが行えることが保証されます。
act を使用することで、アサーションを行う前にすべての更新の適用が完了していることが保証されます。
テスト内でイベントをディスパッチする
イベントをテストするには、イベントのディスパッチを act() 内にラップします。
import {act} from 'react';
import ReactDOMClient from 'react-dom/client';
import Counter from './Counter';
it.only('can render and update a counter', async () => {
const container = document.createElement('div');
document.body.appendChild(container);
await act( async () => {
ReactDOMClient.createRoot(container).render(<Counter />);
});
// ✅ Dispatch the event inside act().
await act(async () => {
button.dispatchEvent(new MouseEvent('click', { bubbles: true }));
});
const button = container.querySelector('button');
const label = container.querySelector('p');
expect(label.textContent).toBe('You clicked 1 times');
expect(document.title).toBe('You clicked 1 times');
});ここでは、act でコンポーネントをレンダーし、その後別の act() 内でイベントをディスパッチしています。これにより、イベントに伴うすべての更新が適用されてからアサーションを行えることが保証されます。
トラブルシューティング
エラー：“The current testing environment is not configured to support act”(…)”
act を使用するには、テスト環境で global.IS_REACT_ACT_ENVIRONMENT=true を設定する必要があります。これは act が正しい環境でのみ使用されることを保証するためです。
このグローバル変数を設定しない場合、次のようなエラーが表示されます。
これを修正するには、React テストのグローバルセットアップファイルに次のコードを追加します。
global.IS_REACT_ACT_ENVIRONMENT=true