Buscar RequestInit - com escopo, global
A API RequestInit fornece opções para configurar uma solicitação de busca.
Você pode passar um objeto RequestInit para o construtor Request() ou diretamente para a chamada de função fetch(). Você também pode criar uma solicitação com uma chamada RequestInit() e passar a solicitação para uma chamada fetch() junto com outro RequestInit(). Se você fizer isso quando a mesma opção estiver definida em ambos os locais, o valor passado diretamente para fetch() será usado.
- Buscar - fetch (recurso de cadeia de caracteres, opções de objeto): inicia o processo de busca de um recurso da rede.
- Buscar cabeçalhos - com escopo, global: recuperar e modificar cabeçalhos de solicitação e resposta.
- Buscar solicitação - com escopo, global: criar um novo objeto de solicitação.
- Buscar RequestInit - com escopo, global: defina opções para configurar uma solicitação de busca.
- Buscar resposta - com escopo, global: criar um novo objeto de resposta.
Para oferecer suporte a ações de busca, a propriedade do sistema, glide.hosts.allowlist, permite controles sobre quais hosts um método de busca pode acessar. Aplica-se a APIs HTTP como RestMessageV2 e as mencionadas acima. Para obter mais informações sobre glide.hosts.allowlist, consulte Available system properties.
Buscar RequestInit - RequestInit
Defina opções para configurar uma solicitação de busca. Você pode passar um objeto RequestInit para o construtor Request() ou diretamente para a chamada de função fetch().
Propriedades RequestInit
A API RequestInit oferece suporte a várias propriedades opcionais que podem ser usadas para configurar o comportamento da solicitação HTTP. Suas propriedades incluem método (método HTTP), cabeçalhos (cabeçalhos de solicitação), corpo (dados a serem enviados), modo (modo CORS), credenciais (detalhes de autenticação), cache (comportamento de cache) e outras como redirecionamento, referenciadore integridade. Essas opções permitem ajustar o comportamento da solicitação para vários casos de uso. Para ler explicações mais detalhadas sobre cada propriedade, consulte https://developer.mozilla.org/en-US/docs/Web/API/RequestInit.
| Nome da propriedade | Descrição |
|---|---|
| atribuiçãoRelatório | Opcional. Indica que você deseja que a resposta da solicitação registre uma origem de atribuição baseada em JavaScript ou um gatilho de atribuição. attributionReporting é um objeto que contém as seguintes propriedades:
Tipo de dados: objeto |
| corpo | Opcional. O corpo da solicitação contém conteúdo a ser enviado ao servidor, por exemplo, em uma solicitação POST ou PUT. Tipos aceitos:
|
| navegaçãoTópicos | Opcional. Sinalizador que indica se os tópicos selecionados para o usuário atual devem ser enviados em um cabeçalho Sec-Browsing-Topics com a solicitação associada. Valores aceitos:
Tipo de dados: booliano |
| cache | Opcional. O modo de cache a ser usado para a solicitação. Valores aceitos:
O modo Tipo de dados: cadeia de caracteres |
| credenciais | Opcional. Controla se o navegador envia ou não credenciais com a solicitação, bem como se os cabeçalhos de resposta Set-Cookie são respeitados. As credenciais são cookies, certificados de cliente TLS ou cabeçalhos de autenticação que contêm um nome de usuário e senha. Valores aceitos:
Padrão: same-origin Tipo de dados: cadeia de caracteres |
| cabeçalhos | Opcional. Todos os cabeçalhos a serem adicionados à sua solicitação, contidos em um objeto Cabeçalhos ou um objeto literal cujas chaves são os nomes dos cabeçalhos e cujos valores são os valores do cabeçalho. Muitos cabeçalhos são definidos automaticamente pelo navegador e não podem ser definidos por um script; eles são chamados de nomes de cabeçalho proibidos. Se a opção Tipo de dados: cadeia de caracteres |
| integridade | Opcional. Contém o valor de integridade de sub-recurso da solicitação. Isso é verificado quando o recurso é obtido. O navegador calcula o hash do recurso obtido usando o algoritmo especificado e, se o resultado não corresponder ao valor especificado, o navegador rejeitará a solicitação de busca com um erro de rede. O formato desta opção é<hash-algo> - <hash-source> em que:
O padrão é uma cadeia de caracteres vazia. Tipo de dados: cadeia de caracteres |
| manter ativo | Opcional. Sinalizador que indica se a solicitação associada deve ser anulada se a página que a iniciou for descarregada antes que a solicitação seja concluída. O tamanho do corpo das solicitações Valores válidos:
Tipo de dados: booliano Padrão: falso |
| method | Opcional. O método request. Tipo de dados: cadeia de caracteres Padrão: GET |
| modo | Opcional. Define o comportamento entre origens da solicitação. Valores válidos:
Tipo de dados: cadeia de caracteres Padrão: cors |
| prioridade | Opcional. Especifica a prioridade da solicitação de busca em relação a outras solicitações do mesmo tipo. Valores válidos:
Tipo de dados: cadeia de caracteres Padrão: automático |
| redirect | Opcional. Determina o comportamento do navegador caso o servidor responda com um status de redirecionamento. Valores aceitos:
Tipo de dados: cadeia de caracteres Padrão: seguir |
| referenciador | Opcional. Uma cadeia de caracteres que especifica o valor a ser usado para o cabeçalho Referenciador da solicitação. Valores e tipos de dados aceitos:
Padrão: sobre:cliente |
| política de referência | Opcional. Uma cadeia de caracteres que define uma política para o cabeçalho Referenciador. A sintaxe e a semântica desta opção são exatamente as mesmas do cabeçalho Referrer-Policy. Tipo de dados: cadeia de caracteres |
| sinal | Opcional. Um AbortSignal. Se esta opção estiver definida, a solicitação poderá ser cancelada chamando abort() no AbortControllercorrespondente.Tipo de dados: cadeia de caracteres |
| Tipo | Descrição |
|---|---|
| Nenhum(a) |
Passar opções para fetch()
Este exemplo mostra como passar as opções de método, corpo e cabeçalhos diretamente para o método fetch() :
async function post() {
const response = await fetch("https://example.org/post", {
method: "POST",
body: JSON.stringify({ username: "example" }),
headers: {
"Content-Type": "application/json",
},
});
console.log(response.status);
}Passar opções para o construtor Request()
Este exemplo mostra como criar uma solicitação e passar as opções de método, corpo e cabeçalhos para o construtor e passar a solicitação para fetch():
async function post() {
const request = new Request("https://example.org/post", {
method: "POST",
body: JSON.stringify({ username: "example" }),
headers: {
"Content-Type": "application/json",
},
});
const response = await fetch(request);
console.log(response.status);
}Passar opções para Request() e fetch()
Este exemplo mostra como criar um Request() e passar as opções de método, corpo e cabeçalhos para o construtor. O script passa a solicitação para fetch() junto com as opções de corpo e referenciador.
- método: "POST"
- cabeçalhos: {"Content-Type": "application/json"}
- corpo: '{"username":"example2"}'
- referenciador: ""
async function post() {
const request = new Request("https://example.org/post", {
method: "POST",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify({ username: "example1" }),
});
const response = await fetch(request, {
body: JSON.stringify({ username: "example2" }),
referrer: "",
});
console.log(response.status);
}