$app/server
import {
function command<Output>(fn: () => Output): RemoteCommand<void, Output> (+2 overloads)Creates a remote command. When called from the browser, the function will be invoked on the server via a fetch call.
See Remote functions for full documentation.
command,
function form<Output>(fn: () => MaybePromise<Output>): RemoteForm<void, Output> (+2 overloads)Creates a form object that can be spread onto a <form> element.
See Remote functions for full documentation.
form,
function getRequestEvent(): RequestEventReturns the current RequestEvent. Can be used inside server hooks, server load functions, actions, and endpoints (and functions called by them).
In environments without AsyncLocalStorage, this must be called synchronously (i.e. not after an await).
getRequestEvent,
function prerender<Output>(fn: () => MaybePromise<Output>, options?: {
inputs?: RemotePrerenderInputsGenerator<void>;
dynamic?: boolean;
} | undefined): RemotePrerenderFunction<void, Output> (+2 overloads)
Creates a remote prerender function. When called from the browser, the function will be invoked on the server via a fetch call.
See Remote functions for full documentation.
prerender,
function query<Output>(fn: () => MaybePromise<Output>): RemoteQueryFunction<void, Output> (+2 overloads)Creates a remote query. When called from the browser, the function will be invoked on the server via a fetch call.
See Remote functions for full documentation.
query,
function read(asset: string): ResponseRead the contents of an imported asset from the filesystem
read,
function requested<Input, Output>(query: RemoteQueryFunction<Input, Output>, limit?: number): RequestedResult<Input>In the context of a remote command or form request, returns an iterable
of the client-requested refreshes' validated arguments up to the supplied limit.
Arguments that fail validation or exceed the limit are recorded as failures in
the response to the client.
requested
} from '$app/server';command
Disponible depuis la version 2.27
Crée une commande distante. Lorsqu'exécutée sur le navigateur, la fonction sera invoquée sur le
serveur via un appel fetch.
Voir la section sur les fonctions distantes pour lire la documentation complète.
function command<Output>(
fn: () => Output
): RemoteCommand<void, Output>;function command<Input, Output>(
validate: 'unchecked',
fn: (arg: Input) => Output
): RemoteCommand<Input, Output>;function command<Schema extends StandardSchemaV1, Output>(
validate: Schema,
fn: (arg: StandardSchemaV1.InferOutput<Schema>) => Output
): RemoteCommand<
StandardSchemaV1.InferInput<Schema>,
Output
>;form
Disponible depuis la version 2.27
Crée un objet de formulaire pouvant être "étalé" sur un élément <form>
Voir la section sur les fonctions distantes pour lire la documentation complète.
function form<Output>(
fn: () => MaybePromise<Output>
): RemoteForm<void, Output>;function form<Input extends RemoteFormInput, Output>(
validate: 'unchecked',
fn: (
data: Input,
issue: InvalidField<Input>
) => MaybePromise<Output>
): RemoteForm<Input, Output>;function form<
Schema extends StandardSchemaV1<
RemoteFormInput,
Record<string, any>
>,
Output
>(
validate: Schema,
fn: (
data: StandardSchemaV1.InferOutput<Schema>,
issue: InvalidField<StandardSchemaV1.InferInput<Schema>>
) => MaybePromise<Output>
): RemoteForm<StandardSchemaV1.InferInput<Schema>, Output>;getRequestEvent
Disponible depuis la version 2.20.0
Renvoie l'objet RequestEvent courant. Peut être utilisé dans les hooks de serveur, les fonctions
load de serveur, les actions, et les endpoints (et dans les fonctions exécutées par ceux-ci).
Dans les environnements ne possédant pas de
AsyncLocalStorage, cette
méthode doit être appelée de manière synchrone (c'est-à-dire pas après un await).
function getRequestEvent(): RequestEvent;prerender
Disponible depuis la version 2.27
Crée une fonction de pré-rendu distante. Lorsqu'exécutée sur le navigateur, la fonction sera
invoquée sur le serveur via un appel fetch.
Voir la section sur les fonctions distantes pour lire la documentation complète.
function prerender<Output>(
fn: () => MaybePromise<Output>,
options?:
| {
inputs?: RemotePrerenderInputsGenerator<void>;
dynamic?: boolean;
}
| undefined
): RemotePrerenderFunction<void, Output>;function prerender<Input, Output>(
validate: 'unchecked',
fn: (arg: Input) => MaybePromise<Output>,
options?:
| {
inputs?: RemotePrerenderInputsGenerator<Input>;
dynamic?: boolean;
}
| undefined
): RemotePrerenderFunction<Input, Output>;function prerender<Schema extends StandardSchemaV1, Output>(
schema: Schema,
fn: (
arg: StandardSchemaV1.InferOutput<Schema>
) => MaybePromise<Output>,
options?:
| {
inputs?: RemotePrerenderInputsGenerator<
StandardSchemaV1.InferInput<Schema>
>;
dynamic?: boolean;
}
| undefined
): RemotePrerenderFunction<
StandardSchemaV1.InferInput<Schema>,
Output
>;query
Disponible depuis la version 2.27
Crée une query distante. Lorsqu'exécutée sur le navigateur, la fonction sera invoquée sur le serveur
via un appel fetch.
Voir la section sur les fonctions distantes pour lire la documentation complète.
function query<Output>(
fn: () => MaybePromise<Output>
): RemoteQueryFunction<void, Output>;function query<Input, Output>(
validate: 'unchecked',
fn: (arg: Input) => MaybePromise<Output>
): RemoteQueryFunction<Input, Output>;function query<Schema extends StandardSchemaV1, Output>(
schema: Schema,
fn: (
arg: StandardSchemaV1.InferOutput<Schema>
) => MaybePromise<Output>
): RemoteQueryFunction<
StandardSchemaV1.InferInput<Schema>,
Output
>;read
Disponible depuis la version 2.4.0
Lit le contenu d'un asset importé depuis le système de fichiers.
import { function read(asset: string): ResponseRead the contents of an imported asset from the filesystem
read } from '$app/server';
import const somefile: stringsomefile from './somefile.txt';
const const asset: Responseasset = function read(asset: string): ResponseRead the contents of an imported asset from the filesystem
read(const somefile: stringsomefile);
const const text: stringtext = await const asset: Responseasset.Body.text(): Promise<string>text();function read(asset: string): Response;requested
Dans le contexte d'une requête distante via command ou form, renvoie un itérable contenant les
arguments validés des mises-à-jour demandées par le client, jusqu'à la limite fournie.
Les arguments échouant la validation ou dépassent la limite sont enregistrés comme des échecs dans
la réponse au client.
import { function requested<Input, Output>(query: RemoteQueryFunction<Input, Output>, limit?: number): RequestedResult<Input>In the context of a remote command or form request, returns an iterable
of the client-requested refreshes' validated arguments up to the supplied limit.
Arguments that fail validation or exceed the limit are recorded as failures in
the response to the client.
requested } from '$app/server';
for (const const arg: unknownarg of requested<unknown, unknown>(query: RemoteQueryFunction<unknown, unknown>, limit?: number): RequestedResult<unknown>In the context of a remote command or form request, returns an iterable
of the client-requested refreshes' validated arguments up to the supplied limit.
Arguments that fail validation or exceed the limit are recorded as failures in
the response to the client.
requested(getPost, 5)) {
// il n'y a pas de risque à ne pas attendre cette promesse — SvelteKit
// va l'attendre pour nous et gérer les éventuelles erreurs
// en les renvoyant au client.
void getPost(const arg: unknownarg).refresh();
}Vous pouvez également appeler refreshAll sur le résultat, en tant que forme raccourcie de
l'exemple précédent :
import { function requested<Input, Output>(query: RemoteQueryFunction<Input, Output>, limit?: number): RequestedResult<Input>In the context of a remote command or form request, returns an iterable
of the client-requested refreshes' validated arguments up to the supplied limit.
Arguments that fail validation or exceed the limit are recorded as failures in
the response to the client.
requested } from '$app/server';
await requested<unknown, unknown>(query: RemoteQueryFunction<unknown, unknown>, limit?: number): RequestedResult<unknown>In the context of a remote command or form request, returns an iterable
of the client-requested refreshes' validated arguments up to the supplied limit.
Arguments that fail validation or exceed the limit are recorded as failures in
the response to the client.
requested(getPost, 5).refreshAll: () => Promise<void>Call refresh on all queries selected by this requested invocation.
This is identical to:
import { requested } from '$app/server';
for await (const arg of requested(query, ...) {
void query(arg).refresh();
}
refreshAll();function requested<Input, Output>(
query: RemoteQueryFunction<Input, Output>,
limit?: number
): RequestedResult<Input>;query
namespace query {
/**
* Crée une fonction de requête groupée qui collecte plusieurs appels et les exécute dans une
* seule requête
*
* Voir [Fonctions distantes](https://svelte.dev/docs/kit/remote-functions#query.batch) pour plus
* d'infos
*
* @since 2.35
*/
function batch<Input, Output>(
validate: 'unchecked',
fn: (
args: Input[]
) => MaybePromise<(arg: Input, idx: number) => Output>
): RemoteQueryFunction<Input, Output>;
/**
* Crée une fonction de requête groupée qui collecte plusieurs appels et les exécute dans une
* seule requête
*
* Voir [Fonctions distantes](https://svelte.dev/docs/kit/remote-functions#query.batch) pour plus
* d'infos
*
* @since 2.35
*/
function batch<Schema extends StandardSchemaV1, Output>(
schema: Schema,
fn: (
args: StandardSchemaV1.InferOutput<Schema>[]
) => MaybePromise<
(
arg: StandardSchemaV1.InferOutput<Schema>,
idx: number
) => Output
>
): RemoteQueryFunction<
StandardSchemaV1.InferInput<Schema>,
Output
>;
}Modifier cette page sur Github llms.txt