From 070efadfb05f0dfb2bf76ffc53607efd60d26287 Mon Sep 17 00:00:00 2001 From: Andrii Date: Thu, 4 Dec 2025 21:04:26 +0100 Subject: [PATCH 1/3] Translate useEffectEvent --- src/content/reference/react/useEffectEvent.md | 533 ++---------------- 1 file changed, 36 insertions(+), 497 deletions(-) diff --git a/src/content/reference/react/useEffectEvent.md b/src/content/reference/react/useEffectEvent.md index 97a659138..cfbd6bb8b 100644 --- a/src/content/reference/react/useEffectEvent.md +++ b/src/content/reference/react/useEffectEvent.md @@ -4,551 +4,90 @@ title: useEffectEvent -`useEffectEvent` is a React Hook that lets you separate events from Effects. +`useEffectEvent` це Хук React, який дозволяє винести **нереактивну логіку** з ваших Ефектів у функцію, яку можна використовувати повторно, — так звану [**Подію Ефекту**](/learn/separating-events-from-effects#declaring-an-effect-event). ```js -const onEvent = useEffectEvent(callback) +const onSomething = useEffectEvent(callback) ``` ---- - -## Reference {/*reference*/} +## Довідка {/*reference*/} ### `useEffectEvent(callback)` {/*useeffectevent*/} -Call `useEffectEvent` at the top level of your component to create an Effect Event. +Викликайте `useEffectEvent` на верхньому рівні вашого компонента, щоб оголосити Подію Ефекту. Події Ефекту — це функції, які ви можете викликати всередині Ефектів, таких як `useEffect`: -```js {4,6} +```js {4-6,11} import { useEffectEvent, useEffect } from 'react'; function ChatRoom({ roomId, theme }) { const onConnected = useEffectEvent(() => { showNotification('Connected!', theme); }); -} -``` - -Effect Events are a part of your Effect logic, but they behave more like an event handler. They always “see” the latest values from render (like props and state) without re-synchronizing your Effect, so they're excluded from Effect dependencies. See [Separating Events from Effects](/learn/separating-events-from-effects#extracting-non-reactive-logic-out-of-effects) to learn more. - -[See more examples below.](#usage) - -#### Parameters {/*parameters*/} - -* `callback`: A function containing the logic for your Effect Event. The function can accept any number of arguments and return any value. When you call the returned Effect Event function, the `callback` always accesses the latest committed values from render at the time of the call. - -#### Returns {/*returns*/} - -`useEffectEvent` returns an Effect Event function with the same type signature as your `callback`. - -You can call this function inside `useEffect`, `useLayoutEffect`, `useInsertionEffect`, or from within other Effect Events in the same component. - -#### Caveats {/*caveats*/} - -* `useEffectEvent` is a Hook, so you can only call it **at the top level of your component** or your own Hooks. You can't call it inside loops or conditions. If you need that, extract a new component and move the Effect Event into it. -* Effect Events can only be called from inside Effects or other Effect Events. Do not call them during rendering or pass them to other components or Hooks. The [`eslint-plugin-react-hooks`](/reference/eslint-plugin-react-hooks) linter enforces this restriction. -* Do not use `useEffectEvent` to avoid specifying dependencies in your Effect's dependency array. This hides bugs and makes your code harder to understand. Only use it for logic that is genuinely an event fired from Effects. -* Effect Event functions do not have a stable identity. Their identity intentionally changes on every render. - - - -#### Why are Effect Events not stable? {/*why-are-effect-events-not-stable*/} - -Unlike `set` functions from `useState` or refs, Effect Event functions do not have a stable identity. Their identity intentionally changes on every render: - -```js -// 🔴 Wrong: including Effect Event in dependencies -useEffect(() => { - onSomething(); -}, [onSomething]); // ESLint will warn about this -``` - -This is a deliberate design choice. Effect Events are meant to be called only from within Effects in the same component. Since you can only call them locally and cannot pass them to other components or include them in dependency arrays, a stable identity would serve no purpose, and would actually mask bugs. - -The non-stable identity acts as a runtime assertion: if your code incorrectly depends on the function identity, you'll see the Effect re-running on every render, making the bug obvious. - -This design reinforces that Effect Events conceptually belong to a particular effect, and are not a general purpose API to opt-out of reactivity. - - - ---- - -## Usage {/*usage*/} - - -### Using an event in an Effect {/*using-an-event-in-an-effect*/} - -Call `useEffectEvent` at the top level of your component to create an *Effect Event*: - - -```js [[1, 1, "onConnected"]] -const onConnected = useEffectEvent(() => { - if (!muted) { - showNotification('Connected!'); - } -}); -``` - -`useEffectEvent` accepts an `event callback` and returns an Effect Event. The Effect Event is a function that can be called inside of Effects without re-connecting the Effect: - -```js [[1, 3, "onConnected"]] -useEffect(() => { - const connection = createConnection(roomId); - connection.on('connected', onConnected); - connection.connect(); - return () => { - connection.disconnect(); - } -}, [roomId]); -``` - -Since `onConnected` is an Effect Event, `muted` and `onConnect` are not in the Effect dependencies. - - - -##### Don't use Effect Events to skip dependencies {/*pitfall-skip-dependencies*/} - -It might be tempting to use `useEffectEvent` to avoid listing dependencies that you think are "unnecessary." However, this hides bugs and makes your code harder to understand: - -```js -// 🔴 Wrong: Using Effect Events to hide dependencies -const logVisit = useEffectEvent(() => { - log(pageUrl); -}); - -useEffect(() => { - logVisit() -}, []); // Missing pageUrl means you miss logs -``` - -If a value should cause your Effect to re-run, keep it as a dependency. Only use Effect Events for logic that genuinely should not re-trigger your Effect. - -See [Separating Events from Effects](/learn/separating-events-from-effects) to learn more. - - - ---- - -### Using a timer with latest values {/*using-a-timer-with-latest-values*/} - -When you use `setInterval` or `setTimeout` in an Effect, you often want to read the latest values from render without restarting the timer whenever those values change. - -This counter increments `count` by the current `increment` value every second. The `onTick` Effect Event reads the latest `count` and `increment` without causing the interval to restart: - - - -```js -import { useState, useEffect, useEffectEvent } from 'react'; - -export default function Timer() { - const [count, setCount] = useState(0); - const [increment, setIncrement] = useState(1); - - const onTick = useEffectEvent(() => { - setCount(count + increment); - }); useEffect(() => { - const id = setInterval(() => { - onTick(); - }, 1000); - return () => { - clearInterval(id); - }; - }, []); - - return ( - <> -

- Counter: {count} - -

-
-

- Every second, increment by: - - {increment} - -

- - ); -} -``` - -```css -button { margin: 10px; } -``` - -
- -Try changing the increment value while the timer is running. The counter immediately uses the new increment value, but the timer keeps ticking smoothly without restarting. - ---- - -### Using an event listener with latest values {/*using-an-event-listener-with-latest-values*/} - -When you set up an event listener in an Effect, you often need to read the latest values from render in the callback. Without `useEffectEvent`, you would need to include the values in your dependencies, causing the listener to be removed and re-added on every change. - -This example shows a dot that follows the cursor, but only when "Can move" is checked. The `onMove` Effect Event always reads the latest `canMove` value without re-running the Effect: - - - -```js -import { useState, useEffect, useEffectEvent } from 'react'; - -export default function App() { - const [position, setPosition] = useState({ x: 0, y: 0 }); - const [canMove, setCanMove] = useState(true); - - const onMove = useEffectEvent(e => { - if (canMove) { - setPosition({ x: e.clientX, y: e.clientY }); - } - }); - - useEffect(() => { - window.addEventListener('pointermove', onMove); - return () => window.removeEventListener('pointermove', onMove); - }, []); - - return ( - <> - -
-
- - ); -} -``` - -```css -body { - height: 200px; -} -``` - - - -Toggle the checkbox and move your cursor. The dot responds immediately to the checkbox state, but the event listener is only set up once when the component mounts. - ---- - -### Avoid reconnecting to external systems {/*showing-a-notification-without-reconnecting*/} - -A common use case for `useEffectEvent` is when you want to do something in response to an Effect, but that "something" depends on a value you don't want to react to. - -In this example, a chat component connects to a room and shows a notification when connected. The user can mute notifications with a checkbox. However, you don't want to reconnect to the chat room every time the user changes the settings: - - - -```json package.json hidden -{ - "dependencies": { - "react": "latest", - "react-dom": "latest", - "react-scripts": "latest", - "toastify-js": "1.12.0" - }, - "scripts": { - "start": "react-scripts start", - "build": "react-scripts build", - "test": "react-scripts test --env=jsdom", - "eject": "react-scripts eject" - } -} -``` - -```js -import { useState, useEffect, useEffectEvent } from 'react'; -import { createConnection } from './chat.js'; -import { showNotification } from './notifications.js'; - -function ChatRoom({ roomId, muted }) { - const onConnected = useEffectEvent((roomId) => { - console.log('✅ Connected to ' + roomId + ' (muted: ' + muted + ')'); - if (!muted) { - showNotification('Connected to ' + roomId); - } - }); - - useEffect(() => { - const connection = createConnection(roomId); - console.log('⏳ Connecting to ' + roomId + '...'); + const connection = createConnection(serverUrl, roomId); connection.on('connected', () => { - onConnected(roomId); + onConnected(); }); connection.connect(); - return () => { - console.log('❌ Disconnected from ' + roomId); - connection.disconnect(); - } + return () => connection.disconnect(); }, [roomId]); - return

Welcome to the {roomId} room!

; -} - -export default function App() { - const [roomId, setRoomId] = useState('general'); - const [muted, setMuted] = useState(false); - return ( - <> - - -
- - - ); -} -``` - -```js src/chat.js -const serverUrl = 'https://localhost:1234'; - -export function createConnection(roomId) { - // A real implementation would actually connect to the server - let connectedCallback; - let timeout; - return { - connect() { - timeout = setTimeout(() => { - if (connectedCallback) { - connectedCallback(); - } - }, 100); - }, - on(event, callback) { - if (connectedCallback) { - throw Error('Cannot add the handler twice.'); - } - if (event !== 'connected') { - throw Error('Only "connected" event is supported.'); - } - connectedCallback = callback; - }, - disconnect() { - clearTimeout(timeout); - } - }; -} -``` - -```js src/notifications.js -import Toastify from 'toastify-js'; -import 'toastify-js/src/toastify.css'; - -export function showNotification(message, theme) { - Toastify({ - text: message, - duration: 2000, - gravity: 'top', - position: 'right', - style: { - background: theme === 'dark' ? 'black' : 'white', - color: theme === 'dark' ? 'white' : 'black', - }, - }).showToast(); + // ... } ``` -```css -label { display: block; margin-top: 10px; } -``` - -
- -Try switching rooms. The chat reconnects and shows a notification. Now mute the notifications. Since `muted` is read inside the Effect Event rather than the Effect, the chat stays connected. - ---- - -### Using Effect Events in custom Hooks {/*using-effect-events-in-custom-hooks*/} - -You can use `useEffectEvent` inside your own custom Hooks. This lets you create reusable Hooks that encapsulate Effects while keeping some values non-reactive: +[Дивіться більше прикладів нижче.](#usage) - +#### Параметри {/*parameters*/} -```js -import { useState, useEffect, useEffectEvent } from 'react'; +- `callback`: Функція, що містить логіку для вашої Події Ефекту. Коли ви визначаєте Подію Ефекту за допомогою `useEffectEvent`, `callback` **завжди** матиме доступ до **найновіших** значень із пропсів і стану, коли він викликається. Це допомагає уникнути проблем із "застарілими замиканнями" (stale closures). -function useInterval(callback, delay) { - const onTick = useEffectEvent(callback); +#### Повертає {/*returns*/} - useEffect(() => { - if (delay === null) { - return; - } - const id = setInterval(() => { - onTick(); - }, delay); - return () => clearInterval(id); - }, [delay]); -} +Повертає функцію Події Ефекту. Ви можете викликати цю функцію всередині `useEffect`, `useLayoutEffect` або `useInsertionEffect`. -function Counter({ incrementBy }) { - const [count, setCount] = useState(0); +#### Застереження {/*caveats*/} - useInterval(() => { - setCount(c => c + incrementBy); - }, 1000); +- **Викликайте лише всередині Ефектів:** Події Ефекту слід викликати лише в Ефектах. Визначайте їх безпосередньо перед Ефектом, який їх використовує. Не передавайте їх іншим компонентам або Хукам. Лінтер [`eslint-plugin-react-hooks`](/reference/eslint-plugin-react-hooks) (версія 6.1.1 або вище) забезпечить дотримання цього обмеження, щоб запобігти виклику Подій Ефекту в неправильному контексті. +- **Це не скорочення для залежностей:** Не використовуйте `useEffectEvent`, щоб уникнути зазначення залежностей у масиві залежностей вашого Ефекту. Це може приховати помилки та ускладнити розуміння вашого коду. Віддайте перевагу явним залежностям або використовуйте refs для порівняння попередніх значень, якщо це необхідно. +- **Використовуйте для нереактивної логіки:** Використовуйте `useEffectEvent` лише для винесення логіки, яка **не залежить** від зміни значень. - return ( -
-

Count: {count}

-

Incrementing by {incrementBy} every second

-
- ); -} - -export default function App() { - const [incrementBy, setIncrementBy] = useState(1); - - return ( - <> - -
- - - ); -} -``` +___ -```css -label { display: block; margin-bottom: 8px; } -``` +## Використання {/*usage*/} -
+### Зчитування найновіших пропсів і стану {/*reading-the-latest-props-and-state*/} -In this example, `useInterval` is a custom Hook that sets up an interval. The `callback` passed to it is wrapped in an Effect Event, so the interval does not reset even if a new `callback` is passed in every render. +Зазвичай, коли ви отримуєте доступ до реактивного значення всередині Ефекту, ви повинні включити його до масиву залежностей. Це гарантує, що ваш Ефект знову запуститься, коли це значення зміниться, що зазвичай є бажаною поведінкою. ---- +Але в деяких випадках ви можете захотіти прочитати найновіші пропси або стан всередині Ефекту, не викликаючи повторного запуску Ефекту при зміні цих значень. -## Troubleshooting {/*troubleshooting*/} +Щоб [прочитати найновіші пропси або стан](/learn/separating-events-from-effects#reading-latest-props-and-state-with-effect-events) у вашому Ефекті, не роблячи ці значення реактивними, включіть їх у Подію Ефекту. -### I'm getting an error: "A function wrapped in useEffectEvent can't be called during rendering" {/*cant-call-during-rendering*/} +```js {7-9,12} +import { useEffect, useContext, useEffectEvent } from 'react'; -This error means you're calling an Effect Event function during the render phase of your component. Effect Events can only be called from inside Effects or other Effect Events. +function Page({ url }) { + const { items } = useContext(ShoppingCartContext); + const numberOfItems = items.length; -```js -function MyComponent({ data }) { - const onLog = useEffectEvent(() => { - console.log(data); + const onNavigate = useEffectEvent((visitedUrl) => { + logVisit(visitedUrl, numberOfItems); }); - // 🔴 Wrong: calling during render - onLog(); - - // ✅ Correct: call from an Effect useEffect(() => { - onLog(); - }, []); - - return
{data}
; -} -``` - -If you need to run logic during render, don't wrap it in `useEffectEvent`. Call the logic directly or move it into an Effect. - ---- - -### I'm getting a lint error: "Functions returned from useEffectEvent must not be included in the dependency array" {/*effect-event-in-deps*/} - -If you see a warning like "Functions returned from `useEffectEvent` must not be included in the dependency array", remove the Effect Event from your dependencies: + onNavigate(url); + }, [url]); -```js -const onSomething = useEffectEvent(() => { // ... -}); - -// 🔴 Wrong: Effect Event in dependencies -useEffect(() => { - onSomething(); -}, [onSomething]); - -// ✅ Correct: no Effect Event in dependencies -useEffect(() => { - onSomething(); -}, []); -``` - -Effect Events are designed to be called from Effects without being listed as dependencies. The linter enforces this because the function identity is [intentionally not stable](#why-are-effect-events-not-stable). Including it would cause your Effect to re-run on every render. - ---- - -### I'm getting a lint error: "... is a function created with useEffectEvent, and can only be called from Effects" {/*effect-event-called-outside-effect*/} - -If you see a warning like "... is a function created with React Hook `useEffectEvent`, and can only be called from Effects and Effect Events", you're calling the function from the wrong place: - -```js -const onSomething = useEffectEvent(() => { - console.log(value); -}); - -// 🔴 Wrong: calling from event handler -function handleClick() { - onSomething(); } - -// 🔴 Wrong: passing to child component -return ; - -// ✅ Correct: calling from Effect -useEffect(() => { - onSomething(); -}, []); ``` -Effect Events are specifically designed to be used in Effects local to the component they're defined in. If you need a callback for event handlers or to pass to children, use a regular function or `useCallback` instead. \ No newline at end of file +У цьому прикладі Ефект повинен повторно запуститися після рендерингу, коли змінюється `url` (щоб зафіксувати відвідування нової сторінки), але він **не** повинен повторно запускатися, коли змінюється `numberOfItems`. Загорнувши логіку логування в Подію Ефекту, `numberOfItems` стає **нереактивним**. Він завжди береться з найновішого значення без запуску Ефекту. + +Ви можете передати реактивні значення, як-от `url`, як аргументи до Події Ефекту, щоб зберегти їх реактивними, отримуючи доступ до найновіших нереактивних значень всередині події. \ No newline at end of file From c8c4979fee08b899ab10088b3644594fe776ac0b Mon Sep 17 00:00:00 2001 From: Andrii Hrushetskyi Date: Mon, 22 Dec 2025 22:21:25 +0100 Subject: [PATCH 2/3] =?UTF-8?q?=D0=92=D0=BD=D0=B5=D1=81=D0=B5=D0=BD=D0=BE?= =?UTF-8?q?=20=D0=B7=D0=BC=D1=96=D0=BD=D0=B8=20=D0=B7=20PR?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/content/reference/react/useEffectEvent.md | 22 +++++++++---------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/src/content/reference/react/useEffectEvent.md b/src/content/reference/react/useEffectEvent.md index cfbd6bb8b..9061492a5 100644 --- a/src/content/reference/react/useEffectEvent.md +++ b/src/content/reference/react/useEffectEvent.md @@ -4,7 +4,7 @@ title: useEffectEvent -`useEffectEvent` це Хук React, який дозволяє винести **нереактивну логіку** з ваших Ефектів у функцію, яку можна використовувати повторно, — так звану [**Подію Ефекту**](/learn/separating-events-from-effects#declaring-an-effect-event). +`useEffectEvent` — це хук React, який дає змогу винести **нереактивну логіку** з ваших ефектів у функцію, яку можна використовувати повторно, — так звану [**Подію ефекту**](/learn/separating-events-from-effects#declaring-an-effect-event). ```js const onSomething = useEffectEvent(callback) @@ -18,7 +18,7 @@ const onSomething = useEffectEvent(callback) ### `useEffectEvent(callback)` {/*useeffectevent*/} -Викликайте `useEffectEvent` на верхньому рівні вашого компонента, щоб оголосити Подію Ефекту. Події Ефекту — це функції, які ви можете викликати всередині Ефектів, таких як `useEffect`: +Викликайте `useEffectEvent` на верхньому рівні вашого компонента, щоб оголосити Подію ефекту. Події ефекту — це функції, які ви можете викликати всередині ефектів, таких як `useEffect`: ```js {4-6,11} import { useEffectEvent, useEffect } from 'react'; @@ -45,16 +45,16 @@ function ChatRoom({ roomId, theme }) { #### Параметри {/*parameters*/} -- `callback`: Функція, що містить логіку для вашої Події Ефекту. Коли ви визначаєте Подію Ефекту за допомогою `useEffectEvent`, `callback` **завжди** матиме доступ до **найновіших** значень із пропсів і стану, коли він викликається. Це допомагає уникнути проблем із "застарілими замиканнями" (stale closures). +- `callback`: Функція, що містить логіку для вашої Події ефекту. Коли ви визначаєте Подію ефекту за допомогою `useEffectEvent`, `callback` **завжди** матиме доступ до **найновіших** значень із пропсів і стану, коли він викликається. Це допомагає уникнути проблем із "застарілими замиканнями" (stale closures). #### Повертає {/*returns*/} -Повертає функцію Події Ефекту. Ви можете викликати цю функцію всередині `useEffect`, `useLayoutEffect` або `useInsertionEffect`. +Повертає функцію Події ефекту. Ви можете викликати цю функцію всередині `useEffect`, `useLayoutEffect` або `useInsertionEffect`. #### Застереження {/*caveats*/} -- **Викликайте лише всередині Ефектів:** Події Ефекту слід викликати лише в Ефектах. Визначайте їх безпосередньо перед Ефектом, який їх використовує. Не передавайте їх іншим компонентам або Хукам. Лінтер [`eslint-plugin-react-hooks`](/reference/eslint-plugin-react-hooks) (версія 6.1.1 або вище) забезпечить дотримання цього обмеження, щоб запобігти виклику Подій Ефекту в неправильному контексті. -- **Це не скорочення для залежностей:** Не використовуйте `useEffectEvent`, щоб уникнути зазначення залежностей у масиві залежностей вашого Ефекту. Це може приховати помилки та ускладнити розуміння вашого коду. Віддайте перевагу явним залежностям або використовуйте refs для порівняння попередніх значень, якщо це необхідно. +- **Викликайте лише всередині ефектів:** Події ефекту слід викликати лише в ефектах. Визначайте їх безпосередньо перед ефектом, який їх використовує. Не передавайте їх іншим компонентам або хукам. Лінтер [`eslint-plugin-react-hooks`](/reference/eslint-plugin-react-hooks) (версія 6.1.1 або вище) забезпечить дотримання цього обмеження, щоб запобігти виклику Подій ефекту в неправильному контексті. +- **Це не скорочення для залежностей:** Не використовуйте `useEffectEvent`, щоб уникнути зазначення залежностей у масиві залежностей вашого ефекту. Це може приховати помилки та ускладнити розуміння вашого коду. Віддайте перевагу явним залежностям або використовуйте refs для порівняння попередніх значень, якщо це необхідно. - **Використовуйте для нереактивної логіки:** Використовуйте `useEffectEvent` лише для винесення логіки, яка **не залежить** від зміни значень. ___ @@ -63,11 +63,11 @@ ___ ### Зчитування найновіших пропсів і стану {/*reading-the-latest-props-and-state*/} -Зазвичай, коли ви отримуєте доступ до реактивного значення всередині Ефекту, ви повинні включити його до масиву залежностей. Це гарантує, що ваш Ефект знову запуститься, коли це значення зміниться, що зазвичай є бажаною поведінкою. +Зазвичай, коли ви отримуєте доступ до реактивного значення всередині ефекту, ви повинні включити його до масиву залежностей. Це гарантує, що ваш ефект знову запуститься, коли це значення зміниться, що зазвичай є бажаною поведінкою. -Але в деяких випадках ви можете захотіти прочитати найновіші пропси або стан всередині Ефекту, не викликаючи повторного запуску Ефекту при зміні цих значень. +Але в деяких випадках ви можете захотіти прочитати найновіші пропси або стан всередині ефекту, не викликаючи повторного запуску ефекту при зміні цих значень. -Щоб [прочитати найновіші пропси або стан](/learn/separating-events-from-effects#reading-latest-props-and-state-with-effect-events) у вашому Ефекті, не роблячи ці значення реактивними, включіть їх у Подію Ефекту. +Щоб [прочитати найновіші пропси або стан](/learn/separating-events-from-effects#reading-latest-props-and-state-with-effect-events) у вашому ефекті, не роблячи ці значення реактивними, включіть їх у Подію ефекту. ```js {7-9,12} import { useEffect, useContext, useEffectEvent } from 'react'; @@ -88,6 +88,6 @@ function Page({ url }) { } ``` -У цьому прикладі Ефект повинен повторно запуститися після рендерингу, коли змінюється `url` (щоб зафіксувати відвідування нової сторінки), але він **не** повинен повторно запускатися, коли змінюється `numberOfItems`. Загорнувши логіку логування в Подію Ефекту, `numberOfItems` стає **нереактивним**. Він завжди береться з найновішого значення без запуску Ефекту. +У цьому прикладі ефект повинен повторно запуститися після рендерингу, коли змінюється `url` (щоб зафіксувати відвідування нової сторінки), але він **не** повинен повторно запускатися, коли змінюється `numberOfItems`. Загорнувши логіку логування в Подію ефекту, `numberOfItems` стає **нереактивним**. Він завжди береться з найновішого значення без запуску ефекту. -Ви можете передати реактивні значення, як-от `url`, як аргументи до Події Ефекту, щоб зберегти їх реактивними, отримуючи доступ до найновіших нереактивних значень всередині події. \ No newline at end of file +Ви можете передати реактивні значення, як-от `url`, як аргументи до Події ефекту, щоб зберегти їх реактивними, отримуючи доступ до найновіших нереактивних значень всередині події. \ No newline at end of file From 44a86e78b0c3d2d569436ac0d8ab9d4d195e4eda Mon Sep 17 00:00:00 2001 From: Andrii Hrushetskyi Date: Mon, 26 Jan 2026 21:48:05 +0100 Subject: [PATCH 3/3] =?UTF-8?q?=D0=92=D0=BD=D0=B5=D1=81=D0=B5=D0=BD=D0=BE?= =?UTF-8?q?=20=D0=B7=D0=BC=D1=96=D0=BD=D0=B8=20=D0=B2=D1=96=D0=B4=20=D1=80?= =?UTF-8?q?=D0=B5=D0=B4=D0=B0=D0=BA=D1=82=D0=BE=D1=80=D0=B0=20=D0=B2=20`us?= =?UTF-8?q?eEffectEvent`.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/content/reference/react/useEffectEvent.md | 28 ++++++++++--------- 1 file changed, 15 insertions(+), 13 deletions(-) diff --git a/src/content/reference/react/useEffectEvent.md b/src/content/reference/react/useEffectEvent.md index 9061492a5..565954b86 100644 --- a/src/content/reference/react/useEffectEvent.md +++ b/src/content/reference/react/useEffectEvent.md @@ -4,7 +4,7 @@ title: useEffectEvent -`useEffectEvent` — це хук React, який дає змогу винести **нереактивну логіку** з ваших ефектів у функцію, яку можна використовувати повторно, — так звану [**Подію ефекту**](/learn/separating-events-from-effects#declaring-an-effect-event). +`useEffectEvent` — це хук React, який дає змогу винести **нереактивну логіку** з ваших ефектів у функцію, яку можна використовувати повторно, — так звану [**подію ефекту**](/learn/separating-events-from-effects#declaring-an-effect-event). ```js const onSomething = useEffectEvent(callback) @@ -14,15 +14,17 @@ const onSomething = useEffectEvent(callback) -## Довідка {/*reference*/} +## Опис {/*reference*/} ### `useEffectEvent(callback)` {/*useeffectevent*/} -Викликайте `useEffectEvent` на верхньому рівні вашого компонента, щоб оголосити Подію ефекту. Події ефекту — це функції, які ви можете викликати всередині ефектів, таких як `useEffect`: +Викликайте `useEffectEvent` на верхньому рівні вашого компонента, щоб оголосити подію ефекту. Події ефекту — це функції, які ви можете викликати всередині ефектів, як-от `useEffect`: ```js {4-6,11} import { useEffectEvent, useEffect } from 'react'; +showNotification('Під'єднано!', theme); + function ChatRoom({ roomId, theme }) { const onConnected = useEffectEvent(() => { showNotification('Connected!', theme); @@ -41,19 +43,19 @@ function ChatRoom({ roomId, theme }) { } ``` -[Дивіться більше прикладів нижче.](#usage) +[Перегляньте більше прикладів нижче.](#usage) #### Параметри {/*parameters*/} -- `callback`: Функція, що містить логіку для вашої Події ефекту. Коли ви визначаєте Подію ефекту за допомогою `useEffectEvent`, `callback` **завжди** матиме доступ до **найновіших** значень із пропсів і стану, коли він викликається. Це допомагає уникнути проблем із "застарілими замиканнями" (stale closures). +- `callback`: Функція, що містить логіку для вашої події ефекту. Коли ви визначаєте подію ефекту за допомогою `useEffectEvent`, `callback` **завжди** матиме доступ до **найновіших** значень із пропсів і стану, коли він викликається. Це допомагає уникнути проблем із "застарілими замиканнями" (stale closures). -#### Повертає {/*returns*/} +#### Результат {/*returns*/} -Повертає функцію Події ефекту. Ви можете викликати цю функцію всередині `useEffect`, `useLayoutEffect` або `useInsertionEffect`. +Повертає функцію події ефекту. Ви можете викликати цю функцію всередині `useEffect`, `useLayoutEffect` або `useInsertionEffect`. #### Застереження {/*caveats*/} -- **Викликайте лише всередині ефектів:** Події ефекту слід викликати лише в ефектах. Визначайте їх безпосередньо перед ефектом, який їх використовує. Не передавайте їх іншим компонентам або хукам. Лінтер [`eslint-plugin-react-hooks`](/reference/eslint-plugin-react-hooks) (версія 6.1.1 або вище) забезпечить дотримання цього обмеження, щоб запобігти виклику Подій ефекту в неправильному контексті. +- **Викликайте лише всередині ефектів:** події ефекту слід викликати лише в ефектах. Визначайте їх безпосередньо перед ефектом, який їх використовує. Не передавайте їх іншим компонентам або хукам. Лінтер [`eslint-plugin-react-hooks`](/reference/eslint-plugin-react-hooks) (версія 6.1.1 або вище) забезпечить дотримання цього обмеження, щоб запобігти виклику подій ефекту в неправильному контексті. - **Це не скорочення для залежностей:** Не використовуйте `useEffectEvent`, щоб уникнути зазначення залежностей у масиві залежностей вашого ефекту. Це може приховати помилки та ускладнити розуміння вашого коду. Віддайте перевагу явним залежностям або використовуйте refs для порівняння попередніх значень, якщо це необхідно. - **Використовуйте для нереактивної логіки:** Використовуйте `useEffectEvent` лише для винесення логіки, яка **не залежить** від зміни значень. @@ -63,11 +65,11 @@ ___ ### Зчитування найновіших пропсів і стану {/*reading-the-latest-props-and-state*/} -Зазвичай, коли ви отримуєте доступ до реактивного значення всередині ефекту, ви повинні включити його до масиву залежностей. Це гарантує, що ваш ефект знову запуститься, коли це значення зміниться, що зазвичай є бажаною поведінкою. +Типово, коли ви використуєте реактивне значення всередині ефекту, ви повинні додати його до масиву залежностей. Це гарантує, що ваш ефект виконуватиметься щоразу, як це значення змінюється, що зазвичай є бажаною поведінкою. -Але в деяких випадках ви можете захотіти прочитати найновіші пропси або стан всередині ефекту, не викликаючи повторного запуску ефекту при зміні цих значень. +Але інколи ви можете захотіти прочитати найновіші пропси або стан всередині ефекту, не cпричиняючи його повторне виконання після зміни цих значень. -Щоб [прочитати найновіші пропси або стан](/learn/separating-events-from-effects#reading-latest-props-and-state-with-effect-events) у вашому ефекті, не роблячи ці значення реактивними, включіть їх у Подію ефекту. +Щоб [прочитати найновіші пропси або стан](/learn/separating-events-from-effects#reading-latest-props-and-state-with-effect-events) у вашому ефекті, не роблячи ці значення реактивними, додайте їх у подію ефекту. ```js {7-9,12} import { useEffect, useContext, useEffectEvent } from 'react'; @@ -88,6 +90,6 @@ function Page({ url }) { } ``` -У цьому прикладі ефект повинен повторно запуститися після рендерингу, коли змінюється `url` (щоб зафіксувати відвідування нової сторінки), але він **не** повинен повторно запускатися, коли змінюється `numberOfItems`. Загорнувши логіку логування в Подію ефекту, `numberOfItems` стає **нереактивним**. Він завжди береться з найновішого значення без запуску ефекту. +У цьому прикладі ефект повинен повторно запуститися після рендерингу, коли змінюється `url` (щоб зафіксувати відвідування нової сторінки), але він **не** повинен повторно запускатися, коли змінюється `numberOfItems`. Загорнувши логіку логування в подію ефекту, `numberOfItems` стає **нереактивним**. Він завжди береться з найновішого значення без запуску ефекту. -Ви можете передати реактивні значення, як-от `url`, як аргументи до Події ефекту, щоб зберегти їх реактивними, отримуючи доступ до найновіших нереактивних значень всередині події. \ No newline at end of file +Ви можете передати реактивні значення, як-от `url`, як аргументи до події ефекту, щоб зберегти їх реактивними, отримуючи доступ до найновіших нереактивних значень всередині події. \ No newline at end of file