Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Vibe Coding: Do Zero ao MVP

    O que é fetch?

    O fetch inicia requisições no JavaScript e permite examinar a resposta recebida. Veja como conferir o status HTTP, ler o corpo e lidar com outra origem.

    Também chamado de: Fetch API, fetch()

    Requisição, resposta e leitura do corpo

    O fetch é uma função que inicia requisições no JavaScript, como uma consulta ao cadastro mantido por um servidor. Ela recebe o endereço do recurso e pode receber opções para definir o método ou enviar um corpo. Seu retorno é uma Promise, um objeto que permite acompanhar a conclusão ou a falha de uma tarefa assíncrona.

    Quando a resposta fica disponível, a Promise é resolvida com um objeto Response. Você já pode examinar o status e os cabeçalhos, mas o corpo ainda pode estar chegando. A leitura exige outra etapa: o método json(), por exemplo, aguarda o corpo completo e tenta interpretá-lo como JSON (JavaScript Object Notation), conforme o guia de uso da Fetch API.

    Uma consulta que recebe HTTP 404

    Uma chamada pode receber o status 404 porque o cadastro consultado não existe. Essa resposta não provoca a rejeição da Promise retornada pelo fetch. O código precisa conferir response.ok, que indica os status de 200 a 299, ou interpretar response.status diretamente. A referência do método distingue esse caso de uma falha de rede.

    Neste exemplo didático, a função consulta /api/cadastro na mesma origem da página. A resposta só segue para a leitura como JSON quando o status pertence à faixa de sucesso.

    async function consultarCadastro() {
    const resposta = await fetch('/api/cadastro')
    if (!resposta.ok) {
    throw new Error('A consulta retornou HTTP ' + resposta.status)
    }
    return resposta.json()
    }

    Com status 200 e o corpo {"nome":"Ana"}, a função resolve sua Promise com um objeto cujo campo nome contém “Ana”. Com status 404, ela lança o erro com o número recebido e não tenta ler o corpo. Uma resposta 200 com HTML também faz a função falhar, mas durante a interpretação como JSON. O código que chama consultarCadastro() ainda precisa capturar essas falhas e mostrar uma mensagem adequada na interface.

    Leitura de respostas de outra origem

    No navegador, o compartilhamento de recursos entre origens, chamado CORS (Cross-Origin Resource Sharing), determina quando o JavaScript pode ler uma resposta de outra origem. A origem combina o esquema do endereço com o host e a porta. Assim, uma página em https://app.example.com e um serviço em https://api.example.com têm origens diferentes.

    Definir mode: 'no-cors' não libera a leitura desse serviço. A resposta opaca prevista no padrão Fetch oculta o corpo e os cabeçalhos do código. Para investigar uma chamada, você pode comparar os cabeçalhos recebidos na aba Network com a mensagem do console. A mesma consulta funcionar no terminal não confirma a autorização exigida pelo navegador.

    Dúvidas frequentes

    Perguntas frequentes sobre fetch

    Uma resposta 404 faz o fetch rejeitar a Promise?
    Uma resposta HTTP 404 pode resolver a Promise normalmente. O fetch rejeita a Promise em falhas como um erro de rede. Para identificar o 404, o código precisa examinar response.status ou verificar response.ok, que só é verdadeiro para os status de 200 a 299.
    O fetch transforma a resposta em JSON automaticamente?
    A chamada fornece um objeto Response. Você usa o método json() para ler o corpo e interpretá-lo como JSON (JavaScript Object Notation). Essa leitura retorna outra Promise e pode falhar mesmo após uma resposta HTTP de sucesso, por exemplo quando o corpo contém HTML.
    O modo no-cors libera a leitura de uma resposta de outra origem?
    Uma requisição a outra origem com no-cors pode produzir uma resposta opaca. O JavaScript recebe o status 0 e não pode ler o corpo nem os cabeçalhos dessa resposta. Para ler a resposta de um serviço de outra origem, a configuração de CORS precisa autorizar o acesso.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Vibe Coding: Do Zero ao MVP

    O fetch permite conectar a interface aos serviços consultados pela aplicação, com tratamento das respostas e das falhas.

    Conhecer a formação
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano