From 0258969cf4c336fc9c2af7ec1ecfb9927651b36b Mon Sep 17 00:00:00 2001 From: "translate-react-bot[bot]" <251169733+translate-react-bot[bot]@users.noreply.github.com> Date: Wed, 4 Feb 2026 15:15:12 +0000 Subject: [PATCH 1/3] =?UTF-8?q?docs:=20translate=20`server-functions.md`?= =?UTF-8?q?=20to=20=D0=A0=D1=83=D1=81=D1=81=D0=BA=D0=B8=D0=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/content/reference/rsc/server-functions.md | 68 +++++++++---------- 1 file changed, 34 insertions(+), 34 deletions(-) diff --git a/src/content/reference/rsc/server-functions.md b/src/content/reference/rsc/server-functions.md index 770f5a705e..52b72ff24b 100644 --- a/src/content/reference/rsc/server-functions.md +++ b/src/content/reference/rsc/server-functions.md @@ -4,15 +4,15 @@ title: Server Functions -Server Functions are for use in [React Server Components](/reference/rsc/server-components). +Server Functions предназначены для использования в [React Server Components](/reference/rsc/server-components). -**Note:** Until September 2024, we referred to all Server Functions as "Server Actions". If a Server Function is passed to an action prop or called from inside an action then it is a Server Action, but not all Server Functions are Server Actions. The naming in this documentation has been updated to reflect that Server Functions can be used for multiple purposes. +**Примечание:** До сентября 2024 года мы называли все Server Functions «Server Actions». Если Server Function передается в action prop или вызывается изнутри action, то это Server Action, но не все Server Functions являются Server Actions. Названия в этой документации были обновлены, чтобы отразить, что Server Functions могут использоваться для различных целей. -Server Functions allow Client Components to call async functions executed on the server. +Server Functions позволяют Client Components вызывать асинхронные функции, выполняющиеся на сервере. @@ -20,23 +20,23 @@ Server Functions allow Client Components to call async functions executed on the -#### How do I build support for Server Functions? {/*how-do-i-build-support-for-server-functions*/} +#### Как мне реализовать поддержку Server Functions? {/*how-do-i-build-support-for-server-functions*/} -While Server Functions in React 19 are stable and will not break between minor versions, the underlying APIs used to implement Server Functions in a React Server Components bundler or framework do not follow semver and may break between minors in React 19.x. +Хотя Server Functions в React 19 стабильны и не будут ломаться между минорными версиями, базовые API, используемые для реализации Server Functions в бандлере или фреймворке React Server Components, не следуют semver и могут ломаться между минорными версиями React 19.x. -To support Server Functions as a bundler or framework, we recommend pinning to a specific React version, or using the Canary release. We will continue working with bundlers and frameworks to stabilize the APIs used to implement Server Functions in the future. +Для поддержки Server Functions в качестве бандлера или фреймворка мы рекомендуем зафиксировать определенную версию React или использовать Canary release. Мы продолжим работать с бандлерами и фреймворками над стабилизацией API, используемых для реализации Server Functions в будущем. -When a Server Function is defined with the [`"use server"`](/reference/rsc/use-server) directive, your framework will automatically create a reference to the server function, and pass that reference to the Client Component. When that function is called on the client, React will send a request to the server to execute the function, and return the result. +Когда Server Function определяется с директивой [`"use server"`](/reference/rsc/use-server), ваш фреймворк автоматически создаст ссылку на серверную функцию и передаст эту ссылку в Client Component. Когда эта функция вызывается на клиенте, React отправит запрос на сервер для выполнения функции и вернет результат. -Server Functions can be created in Server Components and passed as props to Client Components, or they can be imported and used in Client Components. +Server Functions могут быть созданы в Server Components и переданы в качестве пропсов в Client Components, либо они могут быть импортированы и использованы в Client Components. -## Usage {/*usage*/} +## Использование {/*usage*/} -### Creating a Server Function from a Server Component {/*creating-a-server-function-from-a-server-component*/} +### Создание Server Function из Server Component {/*creating-a-server-function-from-a-server-component*/} -Server Components can define Server Functions with the `"use server"` directive: +Server Components могут определять Server Functions с директивой `"use server"`: ```js [[2, 7, "'use server'"], [1, 5, "createNoteAction"], [1, 12, "createNoteAction"]] // Server Component @@ -54,7 +54,7 @@ function EmptyNote () { } ``` -When React renders the `EmptyNote` Server Component, it will create a reference to the `createNoteAction` function, and pass that reference to the `Button` Client Component. When the button is clicked, React will send a request to the server to execute the `createNoteAction` function with the reference provided: +Когда React рендерит `EmptyNote` Server Component, он создаст ссылку на функцию `createNoteAction` и передаст эту ссылку в `Button` Client Component. При нажатии на кнопку React отправит запрос на сервер для выполнения функции `createNoteAction` с предоставленной ссылкой: ```js {5} "use client"; @@ -66,12 +66,12 @@ export default function Button({onClick}) { } ``` -For more, see the docs for [`"use server"`](/reference/rsc/use-server). +Подробнее см. в документации по [`"use server"`](/reference/rsc/use-server). -### Importing Server Functions from Client Components {/*importing-server-functions-from-client-components*/} +### Импорт Server Functions из Client Components {/*importing-server-functions-from-client-components*/} -Client Components can import Server Functions from files that use the `"use server"` directive: +Client Components могут импортировать Server Functions из файлов, использующих директиву `"use server"`: ```js [[1, 3, "createNote"]] "use server"; @@ -82,7 +82,7 @@ export async function createNote() { ``` -When the bundler builds the `EmptyNote` Client Component, it will create a reference to the `createNote` function in the bundle. When the `button` is clicked, React will send a request to the server to execute the `createNote` function using the reference provided: +Когда бандлер собирает `EmptyNote` Client Component, он создаст ссылку на функцию `createNote` в бандле. При нажатии на `button` React отправит запрос на сервер для выполнения функции `createNote` с предоставленной ссылкой: ```js [[1, 2, "createNote"], [1, 5, "createNote"], [1, 7, "createNote"]] "use client"; @@ -95,11 +95,11 @@ function EmptyNote() { } ``` -For more, see the docs for [`"use server"`](/reference/rsc/use-server). +Подробнее см. в документации по [`"use server"`](/reference/rsc/use-server). -### Server Functions with Actions {/*server-functions-with-actions*/} +### Server Functions с Actions {/*server-functions-with-actions*/} -Server Functions can be called from Actions on the client: +Server Functions могут быть вызваны из Actions на клиенте: ```js [[1, 3, "updateName"]] "use server"; @@ -143,15 +143,15 @@ function UpdateName() { } ``` -This allows you to access the `isPending` state of the Server Function by wrapping it in an Action on the client. +Это позволяет получить доступ к состоянию `isPending` Server Function, обернув ее в Action на клиенте. -For more, see the docs for [Calling a Server Function outside of `
`](/reference/rsc/use-server#calling-a-server-function-outside-of-form) +Подробнее см. в документации по [Вызов Server Function вне ``](/reference/rsc/use-server#calling-a-server-function-outside-of-form) -### Server Functions with Form Actions {/*using-server-functions-with-form-actions*/} +### Server Functions с Form Actions {/*using-server-functions-with-form-actions*/} -Server Functions work with the new Form features in React 19. +Server Functions работают с новыми возможностями Form в React 19. -You can pass a Server Function to a Form to automatically submit the form to the server: +Вы можете передать Server Function в Form для автоматической отправки формы на сервер: ```js [[1, 3, "updateName"], [1, 7, "updateName"]] @@ -168,13 +168,13 @@ function UpdateName() { } ``` -When the Form submission succeeds, React will automatically reset the form. You can add `useActionState` to access the pending state, last response, or to support progressive enhancement. +При успешной отправке формы React автоматически сбросит форму. Вы можете добавить `useActionState` для доступа к состоянию ожидания, последнему полученному ответу или для поддержки прогрессивного улучшения. -For more, see the docs for [Server Functions in Forms](/reference/rsc/use-server#server-functions-in-forms). +Подробнее см. в документации по [Server Functions в Forms](/reference/rsc/use-server#server-functions-in-forms). -### Server Functions with `useActionState` {/*server-functions-with-use-action-state*/} +### Server Functions с `useActionState` {/*server-functions-with-use-action-state*/} -You can call Server Functions with `useActionState` for the common case where you just need access to the action pending state and last returned response: +Вы можете вызывать Server Functions с `useActionState` для распространенного случая, когда вам просто нужен доступ к состоянию ожидания action и последнему возвращенному ответу: ```js [[1, 3, "updateName"], [1, 6, "updateName"], [2, 6, "submitAction"], [2, 9, "submitAction"]] "use client"; @@ -193,13 +193,13 @@ function UpdateName() { } ``` -When using `useActionState` with Server Functions, React will also automatically replay form submissions entered before hydration finishes. This means users can interact with your app even before the app has hydrated. +При использовании `useActionState` с Server Functions React также автоматически воспроизведет отправку формы, введенную до завершения гидратации. Это означает, что пользователи смогут взаимодействовать с вашим приложением еще до того, как оно будет гидратировано. -For more, see the docs for [`useActionState`](/reference/react-dom/hooks/useFormState). +Подробнее см. в документации по [`useActionState`](/reference/react-dom/hooks/useFormState). -### Progressive enhancement with `useActionState` {/*progressive-enhancement-with-useactionstate*/} +### Прогрессивное улучшение с `useActionState` {/*progressive-enhancement-with-useactionstate*/} -Server Functions also support progressive enhancement with the third argument of `useActionState`. +Server Functions также поддерживают прогрессивное улучшение с помощью третьего аргумента `useActionState`. ```js [[1, 3, "updateName"], [1, 6, "updateName"], [2, 6, "/name/update"], [3, 6, "submitAction"], [3, 9, "submitAction"]] "use client"; @@ -217,6 +217,6 @@ function UpdateName() { } ``` -When the permalink is provided to `useActionState`, React will redirect to the provided URL if the form is submitted before the JavaScript bundle loads. +Когда permalink предоставляется `useActionState`, React перенаправит на указанный URL, если форма отправлена до загрузки JavaScript-бандла. -For more, see the docs for [`useActionState`](/reference/react-dom/hooks/useFormState). +Подробнее см. в документации по [`useActionState`](/reference/react-dom/hooks/useFormState). \ No newline at end of file From 7d44fa9dd318f37b4435944ab001f44b88d0b629 Mon Sep 17 00:00:00 2001 From: "translate-react-bot[bot]" <251169733+translate-react-bot[bot]@users.noreply.github.com> Date: Mon, 18 May 2026 16:32:01 +0000 Subject: [PATCH 2/3] =?UTF-8?q?docs:=20translate=20`server-functions.md`?= =?UTF-8?q?=20to=20=D0=A0=D1=83=D1=81=D1=81=D0=BA=D0=B8=D0=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/content/reference/rsc/server-functions.md | 63 +++++++++---------- 1 file changed, 31 insertions(+), 32 deletions(-) diff --git a/src/content/reference/rsc/server-functions.md b/src/content/reference/rsc/server-functions.md index 52b72ff24b..6164916a54 100644 --- a/src/content/reference/rsc/server-functions.md +++ b/src/content/reference/rsc/server-functions.md @@ -1,18 +1,17 @@ --- -title: Server Functions +title: Функции сервера --- - -Server Functions предназначены для использования в [React Server Components](/reference/rsc/server-components). +Серверные функции предназначены для использования в [Компонентах сервера React](/reference/rsc/server-components). -**Примечание:** До сентября 2024 года мы называли все Server Functions «Server Actions». Если Server Function передается в action prop или вызывается изнутри action, то это Server Action, но не все Server Functions являются Server Actions. Названия в этой документации были обновлены, чтобы отразить, что Server Functions могут использоваться для различных целей. +**Примечание:** До сентября 2024 года мы называли все серверные функции «Серверными действиями». Если серверная функция передается в свойство действия или вызывается изнутри действия, то это Серверное действие, но не все серверные функции являются Серверными действиями. Наименования в этой документации были обновлены, чтобы отразить, что серверные функции могут использоваться для различных целей. -Server Functions позволяют Client Components вызывать асинхронные функции, выполняющиеся на сервере. +Серверные функции позволяют клиентским компонентам вызывать асинхронные функции, выполняемые на сервере. @@ -20,31 +19,31 @@ Server Functions позволяют Client Components вызывать асин -#### Как мне реализовать поддержку Server Functions? {/*how-do-i-build-support-for-server-functions*/} +#### Как реализовать поддержку серверных функций? {/*how-do-i-build-support-for-server-functions*/} -Хотя Server Functions в React 19 стабильны и не будут ломаться между минорными версиями, базовые API, используемые для реализации Server Functions в бандлере или фреймворке React Server Components, не следуют semver и могут ломаться между минорными версиями React 19.x. +Хотя серверные функции в React 19 стабильны и не будут нарушаться между минорными версиями, базовые API, используемые для реализации серверных функций в бандлере или фреймворке React Server Components, не следуют semver и могут нарушаться между минорными версиями React 19.x. -Для поддержки Server Functions в качестве бандлера или фреймворка мы рекомендуем зафиксировать определенную версию React или использовать Canary release. Мы продолжим работать с бандлерами и фреймворками над стабилизацией API, используемых для реализации Server Functions в будущем. +Для поддержки серверных функций в качестве бандлера или фреймворка мы рекомендуем закрепить определенную версию React или использовать Canary-релиз. Мы продолжим работать с бандлерами и фреймворками над стабилизацией API, используемых для реализации серверных функций в будущем. -Когда Server Function определяется с директивой [`"use server"`](/reference/rsc/use-server), ваш фреймворк автоматически создаст ссылку на серверную функцию и передаст эту ссылку в Client Component. Когда эта функция вызывается на клиенте, React отправит запрос на сервер для выполнения функции и вернет результат. +Когда серверная функция определяется с директивой [`"use server"`](/reference/rsc/use-server), ваш фреймворк автоматически создаст ссылку на серверную функцию и передаст эту ссылку клиентскому компоненту. Когда эта функция вызывается на клиенте, React отправит запрос на сервер для выполнения функции и вернет результат. -Server Functions могут быть созданы в Server Components и переданы в качестве пропсов в Client Components, либо они могут быть импортированы и использованы в Client Components. +Серверные функции могут быть созданы в серверных компонентах и переданы как пропсы клиентским компонентам, либо они могут быть импортированы и использованы в клиентских компонентах. ## Использование {/*usage*/} -### Создание Server Function из Server Component {/*creating-a-server-function-from-a-server-component*/} +### Создание серверной функции из серверного компонента {/*creating-a-server-function-from-a-server-component*/} -Server Components могут определять Server Functions с директивой `"use server"`: +Серверные компоненты могут определять серверные функции с директивой `"use server"`: ```js [[2, 7, "'use server'"], [1, 5, "createNoteAction"], [1, 12, "createNoteAction"]] -// Server Component +// Серверный компонент import Button from './Button'; function EmptyNote () { async function createNoteAction() { - // Server Function + // Серверная функция 'use server'; await db.notes.create(); @@ -54,7 +53,7 @@ function EmptyNote () { } ``` -Когда React рендерит `EmptyNote` Server Component, он создаст ссылку на функцию `createNoteAction` и передаст эту ссылку в `Button` Client Component. При нажатии на кнопку React отправит запрос на сервер для выполнения функции `createNoteAction` с предоставленной ссылкой: +Когда React отрисует серверный компонент `EmptyNote`, он создаст ссылку на функцию `createNoteAction` и передаст эту ссылку клиентскому компоненту `Button`. При нажатии на кнопку React отправит запрос на сервер для выполнения функции `createNoteAction` с предоставленной ссылкой: ```js {5} "use client"; @@ -69,9 +68,9 @@ export default function Button({onClick}) { Подробнее см. в документации по [`"use server"`](/reference/rsc/use-server). -### Импорт Server Functions из Client Components {/*importing-server-functions-from-client-components*/} +### Импорт серверных функций из клиентских компонентов {/*importing-server-functions-from-client-components*/} -Client Components могут импортировать Server Functions из файлов, использующих директиву `"use server"`: +Клиентские компоненты могут импортировать серверные функции из файлов, использующих директиву `"use server"`: ```js [[1, 3, "createNote"]] "use server"; @@ -82,7 +81,7 @@ export async function createNote() { ``` -Когда бандлер собирает `EmptyNote` Client Component, он создаст ссылку на функцию `createNote` в бандле. При нажатии на `button` React отправит запрос на сервер для выполнения функции `createNote` с предоставленной ссылкой: +Когда бандлер соберет клиентский компонент `EmptyNote`, он создаст ссылку на функцию `createNote` в бандле. При нажатии на кнопку `button` React отправит запрос на сервер для выполнения функции `createNote` с предоставленной ссылкой: ```js [[1, 2, "createNote"], [1, 5, "createNote"], [1, 7, "createNote"]] "use client"; @@ -97,9 +96,9 @@ function EmptyNote() { Подробнее см. в документации по [`"use server"`](/reference/rsc/use-server). -### Server Functions с Actions {/*server-functions-with-actions*/} +### Серверные функции с действиями {/*server-functions-with-actions*/} -Server Functions могут быть вызваны из Actions на клиенте: +Серверные функции могут быть вызваны из действий на клиенте: ```js [[1, 3, "updateName"]] "use server"; @@ -143,15 +142,15 @@ function UpdateName() { } ``` -Это позволяет получить доступ к состоянию `isPending` Server Function, обернув ее в Action на клиенте. +Это позволяет получить доступ к состоянию `isPending` серверной функции, обернув ее в действие на клиенте. -Подробнее см. в документации по [Вызов Server Function вне ``](/reference/rsc/use-server#calling-a-server-function-outside-of-form) +Подробнее см. в документации по [Вызов серверной функции вне ``](/reference/rsc/use-server#calling-a-server-function-outside-of-form) -### Server Functions с Form Actions {/*using-server-functions-with-form-actions*/} +### Серверные функции с действиями форм {/*using-server-functions-with-form-actions*/} -Server Functions работают с новыми возможностями Form в React 19. +Серверные функции работают с новыми возможностями форм в React 19. -Вы можете передать Server Function в Form для автоматической отправки формы на сервер: +Вы можете передать серверную функцию в `` для автоматической отправки формы на сервер: ```js [[1, 3, "updateName"], [1, 7, "updateName"]] @@ -168,13 +167,13 @@ function UpdateName() { } ``` -При успешной отправке формы React автоматически сбросит форму. Вы можете добавить `useActionState` для доступа к состоянию ожидания, последнему полученному ответу или для поддержки прогрессивного улучшения. +При успешной отправке формы React автоматически сбросит форму. Вы можете добавить `useActionState` для доступа к состоянию ожидания, последнему ответу или для поддержки прогрессивного улучшения. -Подробнее см. в документации по [Server Functions в Forms](/reference/rsc/use-server#server-functions-in-forms). +Подробнее см. в документации по [Серверные функции в формах](/reference/rsc/use-server#server-functions-in-forms). -### Server Functions с `useActionState` {/*server-functions-with-use-action-state*/} +### Серверные функции с `useActionState` {/*server-functions-with-use-action-state*/} -Вы можете вызывать Server Functions с `useActionState` для распространенного случая, когда вам просто нужен доступ к состоянию ожидания action и последнему возвращенному ответу: +Вы можете вызывать серверные функции с `useActionState` для распространенного случая, когда вам просто нужен доступ к состоянию ожидания действия и последнему полученному ответу: ```js [[1, 3, "updateName"], [1, 6, "updateName"], [2, 6, "submitAction"], [2, 9, "submitAction"]] "use client"; @@ -193,13 +192,13 @@ function UpdateName() { } ``` -При использовании `useActionState` с Server Functions React также автоматически воспроизведет отправку формы, введенную до завершения гидратации. Это означает, что пользователи смогут взаимодействовать с вашим приложением еще до того, как оно будет гидратировано. +При использовании `useActionState` с серверными функциями React также автоматически повторно воспроизведет отправку формы, введенную до завершения гидратации. Это означает, что пользователи могут взаимодействовать с вашим приложением еще до того, как оно будет гидратировано. Подробнее см. в документации по [`useActionState`](/reference/react-dom/hooks/useFormState). ### Прогрессивное улучшение с `useActionState` {/*progressive-enhancement-with-useactionstate*/} -Server Functions также поддерживают прогрессивное улучшение с помощью третьего аргумента `useActionState`. +Серверные функции также поддерживают прогрессивное улучшение с помощью третьего аргумента `useActionState`. ```js [[1, 3, "updateName"], [1, 6, "updateName"], [2, 6, "/name/update"], [3, 6, "submitAction"], [3, 9, "submitAction"]] "use client"; @@ -217,6 +216,6 @@ function UpdateName() { } ``` -Когда permalink предоставляется `useActionState`, React перенаправит на указанный URL, если форма отправлена до загрузки JavaScript-бандла. +Когда постоянная ссылка предоставляется `useActionState`, React перенаправит на указанный URL, если форма отправлена до загрузки JavaScript-бандла. Подробнее см. в документации по [`useActionState`](/reference/react-dom/hooks/useFormState). \ No newline at end of file From ae019f83f6173259390dc5d3b109494ec0ce976a Mon Sep 17 00:00:00 2001 From: nivaldo Date: Mon, 18 May 2026 14:46:45 -0300 Subject: [PATCH 3/3] chore: keep frontmatter title as-is --- src/content/reference/rsc/server-functions.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/src/content/reference/rsc/server-functions.md b/src/content/reference/rsc/server-functions.md index 6164916a54..2f24116aa9 100644 --- a/src/content/reference/rsc/server-functions.md +++ b/src/content/reference/rsc/server-functions.md @@ -1,6 +1,7 @@ --- -title: Функции сервера +title: Server Functions --- + Серверные функции предназначены для использования в [Компонентах сервера React](/reference/rsc/server-components). @@ -218,4 +219,4 @@ function UpdateName() { Когда постоянная ссылка предоставляется `useActionState`, React перенаправит на указанный URL, если форма отправлена до загрузки JavaScript-бандла. -Подробнее см. в документации по [`useActionState`](/reference/react-dom/hooks/useFormState). \ No newline at end of file +Подробнее см. в документации по [`useActionState`](/reference/react-dom/hooks/useFormState).