# Primeiro Elemento

Obtém o primeiro elemento de um array usando lodash _.head

> Página canônica: https://elysiatools.com/pt/tools/head-item

- **Categoria:** Data Processing

- **Palavras-chave:** array, cabeça, primeiro, elemento, lodash, acesso

## Visão geral

Recupera o primeiro elemento de um array.

## Recursos:
- Obtém o primeiro elemento de qualquer array
- Retorna undefined para arrays vazios
- Manipula arrays com qualquer tipo de dado
- Operação simples e direta
- Usa lodash _.head para acesso confiável

## Exemplos:
- Entrada: [1, 2, 3] → Saída: 1
- Entrada: ["a", "b", "c"] → Saída: "a"
- Entrada: [{id: 1}, {id: 2}] → Saída: {id: 1}
- Entrada: [] → Saída: undefined

## Casos de Uso:
- **Visualização Rápida**: Pré-visualizar o primeiro item de uma coleção
- **Validação de Dados**: Verificar o primeiro elemento dos dados
- **Processamento de Arrays**: Processar o elemento principal separadamente
- **Operações de Fila**: Dar uma olhada na frente de uma fila

## Entradas

- **Entrada do Array** (textarea): Insira um array JSON válido

## Quando usar

- Quando você precisa visualizar rapidamente o item inicial de uma lista de dados.
- Ao validar a estrutura de um array para garantir que ele não esteja vazio antes de processá-lo.
- Para isolar o elemento principal de uma coleção em fluxos de trabalho de automação.

## Como funciona

- Insira o seu array no campo de entrada no formato JSON.
- A ferramenta processa o array utilizando a função _.head do lodash.
- O primeiro elemento é extraído instantaneamente, ou retorna 'undefined' caso o array esteja vazio.

## Casos de uso

- Pré-visualização rápida de itens em coleções de dados.
- Verificação de integridade de dados ao validar o primeiro elemento de uma lista.
- Extração do elemento principal para operações de fila ou processamento sequencial.

## Perguntas frequentes

### O que acontece se o array estiver vazio?

A ferramenta retornará 'undefined' como resultado.

### Quais tipos de dados o array pode conter?

A ferramenta aceita arrays contendo números, strings, objetos ou qualquer outro tipo de dado válido em JSON.

### Esta ferramenta altera o array original?

Não, a ferramenta apenas lê o array e retorna o primeiro elemento sem modificar a entrada original.

### Posso usar arrays de objetos?

Sim, a ferramenta retornará o primeiro objeto completo contido no array.

### A ferramenta é baseada em qual tecnologia?

Ela utiliza a função _.head da biblioteca lodash para garantir um acesso seguro e padronizado ao primeiro elemento.

## Ferramentas relacionadas

- [Encontrar chave](https://elysiatools.com/pt/tools/find-key): Encontra a primeira chave com lodash _.findKey
- [Obter caminho](https://elysiatools.com/pt/tools/get-path): Obtem um valor por caminho com lodash _.get
- [Índice De](https://elysiatools.com/pt/tools/index-of): Encontra o índice de um valor em um array usando lodash _.indexOf
- [Itens Iniciais](https://elysiatools.com/pt/tools/initial-items): Obtém todos os elementos exceto o último usando lodash _.initial
- [Item N](https://elysiatools.com/pt/tools/nth-item): Obtem o item em um indice usando lodash _.nth
- [Indice Ordenado](https://elysiatools.com/pt/tools/sorted-index): Encontra o indice de insercao com lodash _.sortedIndex
- [Cauda do Array](https://elysiatools.com/pt/tools/tail-items): Retorna tudo exceto o primeiro com lodash _.tail
- [Pegar Itens](https://elysiatools.com/pt/tools/take-items): Pega os primeiros N itens com lodash _.take

## Exemplos

- [Exemplos Avançados de Aplicação Grafana](https://elysiatools.com/pt/samples/grafana-samples): Exemplos compreensivos de Grafana cobrindo design avançado de dashboards, configuração de alertas, integração de fontes de dados e desenvolvimento de plugins
- [Exemplos de Códigos QR](https://elysiatools.com/pt/samples/qrcode-samples): Imagens de código QR de exemplo para testar ferramentas de leitura e geração de código QR
- [Exemplos D3.js Data Visualization](https://elysiatools.com/pt/samples/d3js-data-visualization): Exemplos abrangentes de visualização de dados D3.js incluindo gráficos, mapas, animações e visualizações interativas
- [Exemplos Rome JavaScript Toolchain](https://elysiatools.com/pt/samples/rome): Exemplos de toolchain JavaScript Rome incluindo configuração, linting, formatting, bundling e gerenciamento de projetos