Pular para o conteúdo

Angular

O @unicep/angular traz bindings com signals e RxJS, para Angular 17 ou mais novo e RxJS 7. O pacote não usa decorators, então funciona com o build padrão do Angular.

Janela do terminal
npm install @unicep/angular

O @unicep/core é instalado junto.

O injectCep precisa ser chamado num contexto de injeção, como num campo ou construtor de componente ou serviço.

import { Component, signal } from '@angular/core';
import { injectCep } from '@unicep/angular';
@Component({
selector: 'app-campo-cep',
template: `
<input [value]="valor()" (input)="valor.set($any($event.target).value)" placeholder="00000-000" />
@if (cep.isLoading()) { <p>Buscando…</p> }
@if (cep.error(); as error) { <p>{{ error.message }}</p> }
@if (cep.data(); as endereco) {
<p>{{ endereco.street }}, {{ endereco.neighborhood }} - {{ endereco.city }}/{{ endereco.state }}</p>
}
`,
})
export class CampoCepComponent {
readonly valor = signal('');
readonly cep = injectCep(() => this.valor());
}

A busca só acontece quando o valor é um CEP válido (com ou sem hífen). Se o CEP mudar, o resultado anterior some e a requisição em andamento é cancelada.

injectCep(cep: () => string | null | undefined, options?: {
unicep?: Unicep; // padrão: a instância fornecida pelo token UNICEP
enabled?: () => boolean; // false pausa as consultas, padrão sempre ligado
}): {
data: Signal<Address | undefined>;
error: Signal<Error | undefined>;
isLoading: Signal<boolean>; // true enquanto a consulta do CEP válido atual está em andamento
}

A versão com Observable, para pipelines RxJS. Cancelar a inscrição cancela a requisição.

import { inject } from '@angular/core';
import { lookupCep, UNICEP } from '@unicep/angular';
const unicep = inject(UNICEP);
lookupCep(unicep, '01310100').subscribe((endereco) => console.log(endereco));

O UNICEP é o token de injeção da instância do Unicep. Por padrão, é uma instância compartilhada com todos os providers embutidos. Para mudar providers, timeout, cache ou circuit breaker, forneça a sua:

import { ApplicationConfig } from '@angular/core';
import { Unicep, viaCep, brasilApi } from '@unicep/core';
import { provideUnicep } from '@unicep/angular';
export const appConfig: ApplicationConfig = {
providers: [
provideUnicep(new Unicep({ providers: [viaCep(), brasilApi()], timeoutMs: 3000, cache: {} })),
],
};

O error é um dos erros da unicep, como CepNotFoundError ou AllProvidersFailedError. Todas as opções estão em Providers e no Core.