You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/content/reference/rsc/use-server.md
+13-13Lines changed: 13 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -34,11 +34,11 @@ async function addToCart(data) {
34
34
35
35
Cuando se llama a una Server Function desde el cliente, se realizará una petición de red al servidor que incluye una copia serializada de cualquier argumento pasado. Si la Server Function devuelve un valor, ese valor será serializado y devuelto al cliente.
36
36
37
-
En lugar de marcar funciones individualmente con `'use server'`, puedes añadir la directiva al principio de un archivo para marcar todas las exportaciones dentro de ese archivo como Server Functions que pueden usarse en cualquier lugar, incluyendo su importación en código cliente.
37
+
En lugar de marcar funciones individualmente con `'use server'`, puedes añadir la directiva al principio de un archivo para marcar todas las funciones exportadas dentro de ese archivo como Server Functions, que pueden usarse en cualquier lugar, inclusive en código cliente.
38
38
39
-
#### Consideraciones {/*caveats*/}
39
+
#### Advertencias {/*caveats*/}
40
40
*`'use server'` debe estar al principio de su función o módulo; por encima de cualquier otro código incluyendo importaciones (los comentarios por encima de las directivas están permitidos). Deben escribirse con comillas simples o dobles, no con comillas invertidas.
41
-
*`'use server'` solo puede usarse en archivos del lado del servidor. Las Server Functions resultantes pueden pasarse a Client Components a través de props. Consulta los [tipos soportados para serialización](#serializable-parameters-and-return-values).
41
+
*`'use server'` solo puede usarse en archivos del lado del servidor. Las Server Functions resultantes pueden pasarse a Client Components a través de props. Consulta los [tipos compatibles para serialización](#serializable-parameters-and-return-values).
42
42
* Para importar Server Functions desde [código cliente](/reference/rsc/use-client), la directiva debe usarse a nivel de módulo.
43
43
* Debido a que las llamadas de red subyacentes son siempre asíncronas, `'use server'` solo puede usarse en funciones asíncronas.
44
44
* Siempre trata los argumentos de las Server Functions como entradas no confiables y autoriza cualquier mutación. Consulta [consideraciones de seguridad](#security).
* Objetos que son instancias de cualquier clase (aparte de las incorporadas mencionadas) u objetos con [un prototipo nulo](https://developer.mozilla.org/es/docs/Web/JavaScript/Reference/Global_Objects/Object#null-prototype_objects)
92
+
* Objetos que son instancias de cualquier clase (aparte de las incorporadas mencionadas) u objetos con [un prototipo nulo](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object#null-prototype_objects)
93
93
* Símbolos no registrados globalmente, ej. `Symbol('my new symbol')`
94
-
* Eventos de manejadores de eventos
94
+
* Eventos de controladores de eventos.
95
95
96
-
Los valores de retorno serializables soportados son los mismos que las [props serializables](/reference/rsc/use-client#passing-props-from-server-to-client-components) para un límite de Client Component.
96
+
Los valores de retorno serializables compatibles son los mismos que las [props serializables](/reference/rsc/use-client#passing-props-from-server-to-client-components) para una barrera de Client Component.
97
97
98
98
## Uso {/*usage*/}
99
99
100
100
### Server Functions en formularios {/*server-functions-in-forms*/}
101
101
102
102
El caso de uso más común de las Server Functions será llamar a funciones que mutan datos. En el navegador, el [elemento HTML form](https://developer.mozilla.org/es/docs/Web/HTML/Element/form) es el enfoque tradicional para que un usuario envíe una mutación. Con React Server Components, React introduce soporte de primera clase para Server Functions como Acciones en [formularios](/reference/react-dom/components/form).
103
103
104
-
Aquí hay un formulario que permite a un usuario solicitar un nombre de usuario.
104
+
Aquí hay un formulario que permite solicitar un nombre de usuario.
105
105
106
106
```js [[1, 3, "formData"]]
107
107
// App.js
@@ -124,13 +124,13 @@ export default function App() {
124
124
125
125
En este ejemplo `requestUsername` es una Server Function pasada a un `<form>`. Cuando un usuario envía este formulario, hay una petición de red a la función del servidor `requestUsername`. Al llamar a una Server Function en un formulario, React proporcionará el [FormData](https://developer.mozilla.org/es/docs/Web/API/FormData) del formulario como el primer argumento de la Server Function.
126
126
127
-
Al pasar una Server Function a la `action` del formulario, React puede [mejorar progresivamente](https://developer.mozilla.org/es/docs/Glossary/Progressive_Enhancement) el formulario. Esto significa que los formularios pueden enviarse antes de que se cargue el paquete JavaScript.
127
+
Al pasar una Server Function a la `action` del formulario, React puede [mejorar progresivamente](https://developer.mozilla.org/es/docs/Glossary/Progressive_Enhancement) el formulario. Esto significa que los formularios pueden enviarse antes de que se cargue el bundle de JavaScript.
128
128
129
129
#### Manejo de valores de retorno en formularios {/*handling-return-values*/}
130
130
131
-
En el formulario de solicitud de nombre de usuario, podría haber la posibilidad de que un nombre de usuario no esté disponible. `requestUsername` debería decirnos si falla o no.
131
+
En la solicitud del formulario podría estar la posibilidad de que un nombre de usuario no esté disponible. `requestUsername` debería decirnos si falla o no.
132
132
133
-
Para actualizar la UI basada en el resultado de una Server Function mientras se soporta la mejora progresiva, usa [`useActionState`](/reference/react/useActionState).
133
+
Para actualizar la UI en base al resultado de una Server Function mientras se soporta mejora progresiva, usa [`useActionState`](/reference/react/useActionState).
134
134
135
135
```js
136
136
// requestUsername.js
@@ -211,4 +211,4 @@ export default async function incrementLike() {
211
211
}
212
212
```
213
213
214
-
Para leer un valor de retorno de una Server Function, necesitarás `await` la promesa devuelta.
214
+
Para leer un valor de retorno de una Server Function, necesitas usar `await`en la promesa que retorna.
0 commit comments