Skip to content

Commit c11c951

Browse files
authored
[crud] Fix deps comparison bug (#31599)
Fixes a bug with the experimental `useResourceEffect` hook where we would compare the wrong deps when there happened to be another kind of effect preceding the ResourceEffect. To do this correctly we need to add a pointer to the ResourceEffect's identity on the update. I also unified the previously separate push effect impls for resource effects since they are always pushed together as a unit.
1 parent 64f8951 commit c11c951

File tree

3 files changed

+115
-42
lines changed

3 files changed

+115
-42
lines changed

packages/react-reconciler/src/ReactFiberHooks.js

+39-41
Original file line numberDiff line numberDiff line change
@@ -253,6 +253,7 @@ export type ResourceEffectUpdate = {
253253
update: ((resource: mixed) => void) | void,
254254
deps: Array<mixed> | void | null,
255255
next: Effect,
256+
identity: ResourceEffectIdentity,
256257
};
257258

258259
type StoreInstance<T> = {
@@ -2585,40 +2586,37 @@ function pushSimpleEffect(
25852586
return pushEffectImpl(effect);
25862587
}
25872588

2588-
function pushResourceEffectIdentity(
2589-
tag: HookFlags,
2589+
function pushResourceEffect(
2590+
identityTag: HookFlags,
2591+
updateTag: HookFlags,
25902592
inst: EffectInstance,
25912593
create: () => mixed,
2592-
deps: Array<mixed> | void | null,
2594+
createDeps: Array<mixed> | void | null,
2595+
update: ((resource: mixed) => void) | void,
2596+
updateDeps: Array<mixed> | void | null,
25932597
): Effect {
2594-
const effect: ResourceEffectIdentity = {
2598+
const effectIdentity: ResourceEffectIdentity = {
25952599
resourceKind: ResourceEffectIdentityKind,
2596-
tag,
2600+
tag: identityTag,
25972601
create,
2598-
deps,
2602+
deps: createDeps,
25992603
inst,
26002604
// Circular
26012605
next: (null: any),
26022606
};
2603-
return pushEffectImpl(effect);
2604-
}
2607+
pushEffectImpl(effectIdentity);
26052608

2606-
function pushResourceEffectUpdate(
2607-
tag: HookFlags,
2608-
inst: EffectInstance,
2609-
update: ((resource: mixed) => void) | void,
2610-
deps: Array<mixed> | void | null,
2611-
): Effect {
2612-
const effect: ResourceEffectUpdate = {
2609+
const effectUpdate: ResourceEffectUpdate = {
26132610
resourceKind: ResourceEffectUpdateKind,
2614-
tag,
2611+
tag: updateTag,
26152612
update,
2616-
deps,
2613+
deps: updateDeps,
26172614
inst,
2615+
identity: effectIdentity,
26182616
// Circular
26192617
next: (null: any),
26202618
};
2621-
return pushEffectImpl(effect);
2619+
return pushEffectImpl(effectUpdate);
26222620
}
26232621

26242622
function pushEffectImpl(effect: Effect): Effect {
@@ -2792,15 +2790,12 @@ function mountResourceEffectImpl(
27922790
currentlyRenderingFiber.flags |= fiberFlags;
27932791
const inst = createEffectInstance();
27942792
inst.destroy = destroy;
2795-
hook.memoizedState = pushResourceEffectIdentity(
2793+
hook.memoizedState = pushResourceEffect(
27962794
HookHasEffect | hookFlags,
2795+
hookFlags,
27972796
inst,
27982797
create,
27992798
createDeps,
2800-
);
2801-
hook.memoizedState = pushResourceEffectUpdate(
2802-
hookFlags,
2803-
inst,
28042799
update,
28052800
updateDeps,
28062801
);
@@ -2847,25 +2842,31 @@ function updateResourceEffectImpl(
28472842
const prevEffect: Effect = currentHook.memoizedState;
28482843
if (nextCreateDeps !== null) {
28492844
let prevCreateDeps;
2850-
// Seems sketchy but in practice we always push an Identity and an Update together. For safety
2851-
// we error in DEV if this does not hold true.
2852-
if (prevEffect.resourceKind === ResourceEffectUpdateKind) {
2845+
if (
2846+
prevEffect.resourceKind != null &&
2847+
prevEffect.resourceKind === ResourceEffectUpdateKind
2848+
) {
28532849
prevCreateDeps =
2854-
prevEffect.next.deps != null ? prevEffect.next.deps : null;
2850+
prevEffect.identity.deps != null ? prevEffect.identity.deps : null;
28552851
} else {
2856-
if (__DEV__) {
2857-
console.error(
2858-
'Expected a ResourceEffectUpdateKind to be pushed together with ' +
2859-
'ResourceEffectIdentityKind, got %s. This is a bug in React.',
2860-
prevEffect.resourceKind,
2861-
);
2862-
}
2863-
prevCreateDeps = prevEffect.deps != null ? prevEffect.deps : null;
2852+
throw new Error(
2853+
`Expected a ResourceEffectUpdate to be pushed together with ResourceEffectIdentity. This is a bug in React.`,
2854+
);
28642855
}
28652856
isCreateDepsSame = areHookInputsEqual(nextCreateDeps, prevCreateDeps);
28662857
}
28672858
if (nextUpdateDeps !== null) {
2868-
const prevUpdateDeps = prevEffect.deps != null ? prevEffect.deps : null;
2859+
let prevUpdateDeps;
2860+
if (
2861+
prevEffect.resourceKind != null &&
2862+
prevEffect.resourceKind === ResourceEffectUpdateKind
2863+
) {
2864+
prevUpdateDeps = prevEffect.deps != null ? prevEffect.deps : null;
2865+
} else {
2866+
throw new Error(
2867+
`Expected a ResourceEffectUpdate to be pushed together with ResourceEffectIdentity. This is a bug in React.`,
2868+
);
2869+
}
28692870
isUpdateDepsSame = areHookInputsEqual(nextUpdateDeps, prevUpdateDeps);
28702871
}
28712872
}
@@ -2874,15 +2875,12 @@ function updateResourceEffectImpl(
28742875
currentlyRenderingFiber.flags |= fiberFlags;
28752876
}
28762877

2877-
hook.memoizedState = pushResourceEffectIdentity(
2878+
hook.memoizedState = pushResourceEffect(
28782879
isCreateDepsSame ? hookFlags : HookHasEffect | hookFlags,
2880+
isUpdateDepsSame ? hookFlags : HookHasEffect | hookFlags,
28792881
inst,
28802882
create,
28812883
nextCreateDeps,
2882-
);
2883-
hook.memoizedState = pushResourceEffectUpdate(
2884-
isUpdateDepsSame ? hookFlags : HookHasEffect | hookFlags,
2885-
inst,
28862884
update,
28872885
nextUpdateDeps,
28882886
);

packages/react-reconciler/src/__tests__/ReactHooksWithNoopRenderer-test.js

+73
Original file line numberDiff line numberDiff line change
@@ -3927,6 +3927,79 @@ describe('ReactHooksWithNoopRenderer', () => {
39273927
</>,
39283928
);
39293929
});
3930+
3931+
// @gate enableUseResourceEffectHook
3932+
it('composes with other kinds of effects', async () => {
3933+
let rerender;
3934+
function App({id, username}) {
3935+
const [count, rerender_] = useState(0);
3936+
rerender = rerender_;
3937+
const opts = useMemo(() => {
3938+
return {username};
3939+
}, [username]);
3940+
useEffect(() => {
3941+
Scheduler.log(`useEffect(${count})`);
3942+
}, [count]);
3943+
useResourceEffect(
3944+
() => {
3945+
const resource = new Resource(id, opts);
3946+
Scheduler.log(`create(${resource.id}, ${resource.opts.username})`);
3947+
return resource;
3948+
},
3949+
[id],
3950+
resource => {
3951+
resource.update(opts);
3952+
Scheduler.log(`update(${resource.id}, ${resource.opts.username})`);
3953+
},
3954+
[opts],
3955+
resource => {
3956+
resource.destroy();
3957+
Scheduler.log(`destroy(${resource.id}, ${resource.opts.username})`);
3958+
},
3959+
);
3960+
return null;
3961+
}
3962+
3963+
await act(() => {
3964+
ReactNoop.render(<App id={1} username="Jack" />);
3965+
});
3966+
assertLog(['useEffect(0)', 'create(1, Jack)']);
3967+
3968+
await act(() => {
3969+
ReactNoop.render(<App id={1} username="Lauren" />);
3970+
});
3971+
assertLog(['update(1, Lauren)']);
3972+
3973+
await act(() => {
3974+
ReactNoop.render(<App id={1} username="Lauren" />);
3975+
});
3976+
assertLog([]);
3977+
3978+
await act(() => {
3979+
ReactNoop.render(<App id={1} username="Jordan" />);
3980+
});
3981+
assertLog(['update(1, Jordan)']);
3982+
3983+
await act(() => {
3984+
rerender(n => n + 1);
3985+
});
3986+
assertLog(['useEffect(1)']);
3987+
3988+
await act(() => {
3989+
ReactNoop.render(<App id={1} username="Mofei" />);
3990+
});
3991+
assertLog(['update(1, Mofei)']);
3992+
3993+
await act(() => {
3994+
ReactNoop.render(<App id={2} username="Jack" />);
3995+
});
3996+
assertLog(['destroy(1, Mofei)', 'create(2, Jack)']);
3997+
3998+
await act(() => {
3999+
ReactNoop.render(null);
4000+
});
4001+
assertLog(['destroy(2, Jack)']);
4002+
});
39304003
});
39314004

39324005
describe('useCallback', () => {

scripts/error-codes/codes.json

+3-1
Original file line numberDiff line numberDiff line change
@@ -527,5 +527,7 @@
527527
"539": "Binary RSC chunks cannot be encoded as strings. This is a bug in the wiring of the React streams.",
528528
"540": "String chunks need to be passed in their original shape. Not split into smaller string chunks. This is a bug in the wiring of the React streams.",
529529
"541": "Compared context values must be arrays",
530-
"542": "Suspense Exception: This is not a real error! It's an implementation detail of `useActionState` to interrupt the current render. You must either rethrow it immediately, or move the `useActionState` call outside of the `try/catch` block. Capturing without rethrowing will lead to unexpected behavior.\n\nTo handle async errors, wrap your component in an error boundary."
530+
"542": "Suspense Exception: This is not a real error! It's an implementation detail of `useActionState` to interrupt the current render. You must either rethrow it immediately, or move the `useActionState` call outside of the `try/catch` block. Capturing without rethrowing will lead to unexpected behavior.\n\nTo handle async errors, wrap your component in an error boundary.",
531+
"543": "Expected a ResourceEffectUpdate to be pushed together with ResourceEffectIdentity. This is a bug in React."
531532
}
533+

0 commit comments

Comments
 (0)