O que é Biblioteca?

Código reutilizável para uma função

Biblioteca é um conjunto de funcionalidades que outros programas podem utilizar. Ela pode oferecer recursos para formatar datas, validar estruturas ou produzir arquivos, entre muitas outras finalidades. Seu código chama a interface disponível e utiliza o resultado conforme o contrato da biblioteca.

A biblioteca pode ser mantida pelo projeto, acompanhar a linguagem ou ser distribuída por terceiros. Ela não precisa estar publicada em um registro público. O que caracteriza seu uso é o reaproveitamento de funcionalidades por outro código.

Imagine que várias partes da aplicação precisam exibir datas no mesmo formato. Uma função compartilhada pode concentrar esse comportamento. Assim, cada tela fornece a data e recebe a representação definida para aquele uso.

Interface, argumentos e retorno

import { formatarData } from './formatacao.js'

const texto = formatarData('2026-09-23')
console.log(texto)

O exemplo pressupõe que o arquivo local exporte a função indicada. Ele não corresponde a um pacote que você precisa instalar. O contrato dessa função deve explicar os valores aceitos, o formato retornado e o tratamento de entradas inválidas.

O contrato também informa como obter o resultado: uma função pode devolver o texto diretamente, enquanto outra retorna uma promise que será resolvida depois. No exemplo de formatação, confira como a função responde a uma data inválida e se exige configuração de idioma ou fuso. Esses comportamentos determinam como o código que a chama deve tratar o retorno.

Biblioteca, pacote e framework

Pacote é uma unidade de distribuição. Ele pode conter uma biblioteca, uma ferramenta de terminal, arquivos de tipos ou outros recursos. Portanto, nem todo pacote instalado é uma biblioteca chamada diretamente pelo seu código.

Framework costuma oferecer uma estrutura mais ampla para organizar a aplicação e chamar funções definidas por você em pontos previstos. Uma biblioteca geralmente é chamada pelo programa para executar tarefas. Essa distinção é útil, mas produtos reais podem combinar características dos dois.

O que conferir antes de usar

Leia a documentação da versão escolhida e verifique a compatibilidade com o runtime do projeto. Confira também licença, manutenção e dependências adicionais. Uma biblioteca popular ainda pode não atender ao formato ou ambiente de que você precisa.

Registre a dependência pelo mecanismo do projeto e teste as funções que entram no comportamento da aplicação. Evite pressupor que toda funcionalidade está correta apenas por vir de um pacote externo. O verbete de framework explica uma forma diferente de organizar o reaproveitamento de software.

Aplicação na formação

Vibe Coding: Do Zero ao MVP

Bibliotecas acrescentam funções reutilizáveis que precisam ser integradas e conferidas no projeto.

Conhecer a formação →