erro

Uma Ferramenta Sumor Cloud.
Mais Documentação Uma biblioteca de tratamento de erros com suporte a vários idiomas, código de erro predefinido e passagem de dados.

CI](https://github.com/sumor-cloud/error/actions/workflows/ci.yml) Teste Cobertura Auditoria

Instalação

npm i @sumor/error --save

Pré-requisitos

Versão do Node.JS

Requer Node.JS na versão 16.x ou superior

Requerir módulo ES do Node.JS

Como este pacote é escrito em módulo ES, por favor altere o seguinte código no seu arquivo package.json:

{
  "type": "module"
}

Utilização

Definir Erro

import defineError from '@sumor/error'

const MeuErro = defineError({
  code: {
    USUÁRIO_NÃO_ENCONTRADO: 'Usuário não encontrado',
    USUÁRIO_EXISTENTE: 'Usuário {name} existente'
  }
})

throw new MeuErro('USUÁRIO_NÃO_ENCONTRADO')
// saída: Error: Usuário não encontrado

throw new MeuErro('USUÁRIO_EXISTENTE', { name: 'Alice' })
// saída: Error: Usuário Alice existente

Multi-idioma

import defineError from '@sumor/error'

const MeuErro = defineError({
  language: 'en', // idioma padrão
  code: {
    USUÁRIO_NÃO_ENCONTRADO: 'Usuário não encontrado',
    USUÁRIO_EXISTENTE: 'Usuário {name} existente'
  },
  i18n: {
    zh: {
      USUÁRIO_NÃO_ENCONTRADO: 'Usuário não encontrado',
      USUÁRIO_EXISTENTE: 'Usuário {name} existente'
    }
  }
})

const erro = new MeuErro('USUÁRIO_EXISTENTE', { name: 'Alice' })
erro.language = 'en' // alterar idioma do erro
console.log(erro)
// saída: Error: Usuário Alice existente

erro.language = 'zh' // alterar idioma do erro
console.log(erro)
// saída: Error: Usuário Alice existente

Converter Erro para JSON

import defineError from '@sumor/error'

const MeuErro = defineError({
  code: {
    USUÁRIO_NÃO_ENCONTRADO: 'Usuário não encontrado',
    USUÁRIO_EXISTENTE: 'Usuário {name} existente'
  }
})

const erro = new MeuErro('USUÁRIO_EXISTENTE', { name: 'Alice' })
console.log(erro.json())
// saída: {"code":"USUÁRIO_EXISTENTE","message":"Usuário Alice existente"}

Erro Subjacente

import defineError from '@sumor/error'

const MeuErro = defineError({
  code: {
    VERIFICAÇÃO_DE_CAMPO_FALHOU: 'Verificação do campo falhou',
    CAMPO_NÃO_PODE_FICAR_VAZIO: 'Campo {name} não pode ficar vazio',
    CAMPO_LONGO_DEMAIS: 'Campo {name} está muito longo'
  },
  i18n: {
    zh: {
      VERIFICAÇÃO_DE_CAMPO_FALHOU: 'Verificação do campo falhou',
      CAMPO_NÃO_PODE_FICAR_VAZIO: 'Campo {name} não pode ficar vazio',
      CAMPO_LONGO_DEMAIS: 'Campo {name} está muito longo'
    }
  }
})

const erro = new MeuErro('VERIFICAÇÃO_DE_CAMPO_FALHOU', {}, [
  new MeuErro('CAMPO_NÃO_PODE_FICAR_VAZIO', { name: 'usuário' }),
  new MeuErro('CAMPO_LONGO_DEMAIS', { name: 'senha' })
])

console.log(erro.json())
/* 
saída: 
{
  "code":"VERIFICAÇÃO_DE_CAMPO_FALHOU",
  "message":"Verificação do campo falhou",
  "errors":[
    {
      "code":"CAMPO_NÃO_PODE_FICAR_VAZIO",
      "message":"Campo usuário não pode ficar vazio"
    },{
      "code":"CAMPO_LONGO_DEMAIS",
      "message":"Campo senha está muito longo"
    }
  ]
}
*/

erro.language = 'zh'
console.log(erro.json())
/*
saída:
{
  "code":"VERIFICAÇÃO_DE_CAMPO_FALHOU",
  "message":"Verificação do campo falhou",
  "errors":[
    {
      "code":"CAMPO_NÃO_PODE_FICAR_VAZIO",
      "message":"Campo usuário não pode ficar vazio"
    },{
      "code":"CAMPO_LONGO_DEMAIS",
      "message":"Campo senha está muito longo"
    }
  ]
}
*/

Combinar Erro Padrão

import defineError from '@sumor/error'

const MeuErro = defineError({
  code: {
    VERIFICAÇÃO_DE_CAMPO_FALHOU: 'Verificação do campo falhou',
    CAMPO_NÃO_PODE_FICAR_VAZIO: 'Campo {name} não pode ficar vazio',
    CAMPO_LONGO_DEMAIS: 'Campo {name} está muito longo'
  }
})

const erro = new MeuErro('VERIFICAÇÃO_DE_CAMPO_FALHOU', {}, [
  new MeuErro('CAMPO_NÃO_PODE_FICAR_VAZIO', { name: 'usuário' }),
  new MeuErro('CAMPO_LONGO_DEMAIS', { name: 'senha' }),
  new Error('Erro Desconhecido')
])

console.log(erro.json())
/*
saída:
{
  "code":"VERIFICAÇÃO_DE_CAMPO_FALHOU",
  "message":"Verificação do campo falhou",
  "errors":[
    {
      "code":"CAMPO_NÃO_PODE_FICAR_VAZIO",
      "message":"Campo usuário não pode ficar vazio"
    },{
      "code":"CAMPO_LONGO_DEMAIS",
      "message":"Campo senha está muito longo"
    },{
      "code":"ERRO_DESCONHECIDO",
      "message":"Erro Desconhecido"
    }
  ]
}
 */