Compartilhar via


ServiceBusError class

Erros que ocorrem no Barramento de Serviço.

Extends

Construtores

ServiceBusError(MessagingError)
ServiceBusError(string, ServiceBusErrorCode)

Propriedades

code

O motivo da falha.

  • GeneralError: a exceção foi o resultado de um erro geral na biblioteca de clientes.
  • MessagingEntityNotFound: um recurso do Barramento de Serviço não pode ser encontrado pelo serviço do Barramento de Serviço.
  • MessageLockLost: o bloqueio na mensagem é perdido. Os chamadores devem tentar receber e processar a mensagem novamente.
  • MessageNotFound: a mensagem solicitada não foi encontrada.
  • MessageSizeExceededed: uma mensagem é maior que o tamanho máximo permitido para seu transporte.
  • MessagingEntityAlreadyExists: existe uma entidade com o mesmo nome no mesmo namespace.
  • MessagingEntityDisabled: a Entidade de Mensagens está desabilitada. Habilite a entidade novamente usando o Portal.
  • QuotaExceeded: a cota aplicada a um recurso do Barramento de Serviço foi excedida ao interagir com o serviço barramento de serviço do Azure.
  • ServiceBusy: o serviço do Barramento de Serviço do Azure informa que ele está ocupado em resposta a uma solicitação de cliente para executar uma operação.
  • ServiceTimeout: uma operação ou outra solicitação atingiu o tempo limite ao interagir com o serviço do Barramento de Serviço do Azure.
  • ServiceCommunicationProblem: ocorreu um erro de comunicação geral ao interagir com o serviço do Barramento de Serviço do Azure.
  • SessionCannotBeLocked: a sessão solicitada não pode ser bloqueada.
  • SessionLockLost: o bloqueio na sessão expirou. Os chamadores devem solicitar a sessão novamente.
  • UnauthorizedAccess": o usuário não tem acesso à entidade.

Propriedades herdadas

address

Endereço ao qual a conexão de rede falhou. Só estará presente se o MessagingError tiver sido instanciado com um Node.js SystemError.

errno

Número de erro fornecido pelo sistema. Só estará presente se o MessagingError tiver sido instanciado com um Node.js SystemError.

info

Detalhes extras sobre o erro.

message
name

O nome do erro. Valor padrão: "MessagingError".

port

A porta de conexão de rede indisponível. Só estará presente se o MessagingError tiver sido instanciado com um Node.js SystemError.

retryable

Descreve se o erro é retível. Padrão: true.

stack
stackTraceLimit

A Error.stackTraceLimit propriedade especifica o número de quadros de pilha coletados por um rastreamento de pilha (gerado por new Error().stack ou Error.captureStackTrace(obj)).

O valor padrão é 10 but pode ser definido como qualquer número JavaScript válido. As alterações afetarão qualquer rastreamento de pilha capturado após a alteração do valor.

Se definido como um valor diferente do número ou definido como um número negativo, os rastreamentos de pilha não capturarão nenhum quadro.

syscall

Nome da chamada do sistema que disparou o erro. Só estará presente se o MessagingError tiver sido instanciado com um Node.js SystemError.

Métodos herdados

captureStackTrace(object, Function)

Cria uma .stack propriedade em targetObject, que, quando acessada, retorna uma cadeia de caracteres que representa o local no código no qual Error.captureStackTrace() foi chamado.

const myObject = {};
Error.captureStackTrace(myObject);
myObject.stack;  // Similar to `new Error().stack`

A primeira linha do traço será prefixada com ${myObject.name}: ${myObject.message}.

O argumento opcional constructorOpt aceita uma função. Se fornecido, todos os quadros acima constructorOpt, incluindo constructorOpt, serão omitidos do rastreamento de pilha gerado.

O constructorOpt argumento é útil para ocultar detalhes de implementação da geração de erros do usuário. Por exemplo:

function a() {
  b();
}

function b() {
  c();
}

function c() {
  // Create an error without stack trace to avoid calculating the stack trace twice.
  const { stackTraceLimit } = Error;
  Error.stackTraceLimit = 0;
  const error = new Error();
  Error.stackTraceLimit = stackTraceLimit;

  // Capture the stack trace above function b
  Error.captureStackTrace(error, b); // Neither function c, nor b is included in the stack trace
  throw error;
}

a();
prepareStackTrace(Error, CallSite[])

Consulte https://v8.dev/docs/stack-trace-api#customizing-stack-traces

Detalhes do construtor

ServiceBusError(MessagingError)

new ServiceBusError(messagingError: MessagingError)

Parâmetros

messagingError
MessagingError

Um erro cujas propriedades serão copiadas para o ServiceBusError.

ServiceBusError(string, ServiceBusErrorCode)

new ServiceBusError(message: string, code: ServiceBusErrorCode)

Parâmetros

message

string

A mensagem de erro que fornece mais informações sobre o erro.

code
ServiceBusErrorCode

O motivo da falha.

Detalhes da propriedade

code

O motivo da falha.

  • GeneralError: a exceção foi o resultado de um erro geral na biblioteca de clientes.
  • MessagingEntityNotFound: um recurso do Barramento de Serviço não pode ser encontrado pelo serviço do Barramento de Serviço.
  • MessageLockLost: o bloqueio na mensagem é perdido. Os chamadores devem tentar receber e processar a mensagem novamente.
  • MessageNotFound: a mensagem solicitada não foi encontrada.
  • MessageSizeExceededed: uma mensagem é maior que o tamanho máximo permitido para seu transporte.
  • MessagingEntityAlreadyExists: existe uma entidade com o mesmo nome no mesmo namespace.
  • MessagingEntityDisabled: a Entidade de Mensagens está desabilitada. Habilite a entidade novamente usando o Portal.
  • QuotaExceeded: a cota aplicada a um recurso do Barramento de Serviço foi excedida ao interagir com o serviço barramento de serviço do Azure.
  • ServiceBusy: o serviço do Barramento de Serviço do Azure informa que ele está ocupado em resposta a uma solicitação de cliente para executar uma operação.
  • ServiceTimeout: uma operação ou outra solicitação atingiu o tempo limite ao interagir com o serviço do Barramento de Serviço do Azure.
  • ServiceCommunicationProblem: ocorreu um erro de comunicação geral ao interagir com o serviço do Barramento de Serviço do Azure.
  • SessionCannotBeLocked: a sessão solicitada não pode ser bloqueada.
  • SessionLockLost: o bloqueio na sessão expirou. Os chamadores devem solicitar a sessão novamente.
  • UnauthorizedAccess": o usuário não tem acesso à entidade.
code: ServiceBusErrorCode

Valor da propriedade

Detalhes das propriedades herdadas

address

Endereço ao qual a conexão de rede falhou. Só estará presente se o MessagingError tiver sido instanciado com um Node.js SystemError.

address?: string

Valor da propriedade

string

Herdado deMessagingError.address

errno

Número de erro fornecido pelo sistema. Só estará presente se o MessagingError tiver sido instanciado com um Node.js SystemError.

errno?: string | number

Valor da propriedade

string | number

herdado deMessagingError.errno

info

Detalhes extras sobre o erro.

info?: any

Valor da propriedade

any

herdado deMessagingError.info

message

message: string

Valor da propriedade

string

herdado deMessagingError.message

name

O nome do erro. Valor padrão: "MessagingError".

name: string

Valor da propriedade

string

herdado deMessagingError.name

port

A porta de conexão de rede indisponível. Só estará presente se o MessagingError tiver sido instanciado com um Node.js SystemError.

port?: number

Valor da propriedade

number

Herdado deMessagingError.port

retryable

Descreve se o erro é retível. Padrão: true.

retryable: boolean

Valor da propriedade

boolean

Herdado deMessagingError.retryable

stack

stack?: string

Valor da propriedade

string

herdado deMessagingError.stack

stackTraceLimit

A Error.stackTraceLimit propriedade especifica o número de quadros de pilha coletados por um rastreamento de pilha (gerado por new Error().stack ou Error.captureStackTrace(obj)).

O valor padrão é 10 but pode ser definido como qualquer número JavaScript válido. As alterações afetarão qualquer rastreamento de pilha capturado após a alteração do valor.

Se definido como um valor diferente do número ou definido como um número negativo, os rastreamentos de pilha não capturarão nenhum quadro.

static stackTraceLimit: number

Valor da propriedade

number

Herdado deMessagingError.stackTraceLimit

syscall

Nome da chamada do sistema que disparou o erro. Só estará presente se o MessagingError tiver sido instanciado com um Node.js SystemError.

syscall?: string

Valor da propriedade

string

Herdado deMessagingError.syscall

Detalhes do método herdado

captureStackTrace(object, Function)

Cria uma .stack propriedade em targetObject, que, quando acessada, retorna uma cadeia de caracteres que representa o local no código no qual Error.captureStackTrace() foi chamado.

const myObject = {};
Error.captureStackTrace(myObject);
myObject.stack;  // Similar to `new Error().stack`

A primeira linha do traço será prefixada com ${myObject.name}: ${myObject.message}.

O argumento opcional constructorOpt aceita uma função. Se fornecido, todos os quadros acima constructorOpt, incluindo constructorOpt, serão omitidos do rastreamento de pilha gerado.

O constructorOpt argumento é útil para ocultar detalhes de implementação da geração de erros do usuário. Por exemplo:

function a() {
  b();
}

function b() {
  c();
}

function c() {
  // Create an error without stack trace to avoid calculating the stack trace twice.
  const { stackTraceLimit } = Error;
  Error.stackTraceLimit = 0;
  const error = new Error();
  Error.stackTraceLimit = stackTraceLimit;

  // Capture the stack trace above function b
  Error.captureStackTrace(error, b); // Neither function c, nor b is included in the stack trace
  throw error;
}

a();
static function captureStackTrace(targetObject: object, constructorOpt?: Function)

Parâmetros

targetObject

object

constructorOpt

Function

Herdado deMessagingError.captureStackTrace

prepareStackTrace(Error, CallSite[])

Consulte https://v8.dev/docs/stack-trace-api#customizing-stack-traces

static function prepareStackTrace(err: Error, stackTraces: CallSite[]): any

Parâmetros

err

Error

stackTraces

CallSite[]

Retornos

any

Herdado deMessagingError.prepareStackTrace