Partager via

ServiceBusError class

Paquet:
@azure/service-bus

Erreurs qui se produisent dans Service Bus.

Extends
MessagingError

Constructeurs

ServiceBusError(MessagingError)
ServiceBusError(string, ServiceBusErrorCode)

Propriétés

code

Raison de l’échec.

  • GeneralError: l’exception a été le résultat d’une erreur générale dans la bibliothèque cliente.
  • MessagingEntityNotFound: une ressource Service Bus est introuvable par le service Service Bus.
  • MessageLockLost: le verrou sur le message est perdu. Les appelants doivent tenter de recevoir et de traiter à nouveau le message.
  • MessageNotFound: le message demandé n’a pas été trouvé.
  • MessageSizeExceededed: un message est supérieur à la taille maximale autorisée pour son transport.
  • MessagingEntityAlreadyExists: une entité portant le même nom existe sous le même espace de noms.
  • MessagingEntityDisabled: l’entité de messagerie est désactivée. Réactivez l’entité à l’aide du portail.
  • QuotaExceed: le quota appliqué à une ressource Service Bus a été dépassé lors de l’interaction avec le service Azure Service Bus.
  • ServiceBusy: le service Azure Service Bus signale qu’il est occupé en réponse à une demande cliente pour effectuer une opération.
  • ServiceTimeout: une opération ou une autre requête a expiré lors de l’interaction avec le service Azure Service Bus.
  • ServiceCommunicationProblem: une erreur de communication générale s’est produite lors de l’interaction avec le service Azure Service Bus.
  • SessionCannotBeLocked: la session demandée ne peut pas être verrouillée.
  • SessionLockLost: le verrou sur la session a expiré. Les appelants doivent demander à nouveau la session.
  • Non autoriséAccess : l’utilisateur n’a pas accès à l’entité.

Propriétés héritées

address

Adresse à laquelle la connexion réseau a échoué. Présente uniquement si la MessagingError a été instanciée avec un Node.js SystemError.
errno

Numéro d’erreur fourni par le système. Présente uniquement si la MessagingError a été instanciée avec un Node.js SystemError.
info

Détails supplémentaires sur l’erreur.
message
name

Nom de l’erreur. Valeur par défaut : « MessagingError ».
port

Port de connexion réseau indisponible. Présente uniquement si la MessagingError a été instanciée avec un Node.js SystemError.
retryable

Décrit si l’erreur est retenable. Valeur par défaut : true.
stack
stackTraceLimit

La Error.stackTraceLimit propriété spécifie le nombre de trames de pile collectées par une trace de pile (qu’elle soit générée par new Error().stack ou Error.captureStackTrace(obj)).

La valeur par défaut est 10 mais peut être définie sur n’importe quel numéro JavaScript valide. Les modifications affecteront toute trace de pile capturée après la modification de la valeur.

S’ils sont définis sur une valeur non numérique ou sur un nombre négatif, les traces de pile ne captureront aucune trame.
syscall

Nom de l’appel système qui a déclenché l’erreur. Présente uniquement si la MessagingError a été instanciée avec un Node.js SystemError.

Méthodes héritées

captureStackTrace(object, Function)

Crée une .stack propriété le , targetObjectqui, lorsqu’elle est accédée, renvoie une chaîne représentant l’emplacement dans le code auquel Error.captureStackTrace() a été appelé.

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

La première ligne de la trace sera préfixée par ${myObject.name}: ${myObject.message}.

L’argument facultatif constructorOpt accepte une fonction. Si cette option est donnée, toutes les images au-dessus constructorOptde , y compris constructorOpt, seront omises de la trace de pile générée.

L’argument constructorOpt est utile pour masquer à l’utilisateur les détails de l’implémentation de la génération d’erreurs. Par exemple:

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[])

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

Détails du constructeur

ServiceBusError(MessagingError) 

new ServiceBusError(messagingError: MessagingError)

Paramètres

messagingError
MessagingError

Erreur dont les propriétés seront copiées dans ServiceBusError.

ServiceBusError(string, ServiceBusErrorCode) 

new ServiceBusError(message: string, code: ServiceBusErrorCode)

Paramètres

message

string

Message d’erreur qui fournit plus d’informations sur l’erreur.

code
ServiceBusErrorCode

Raison de l’échec.

Détails de la propriété

code

Raison de l’échec.

  • GeneralError: l’exception a été le résultat d’une erreur générale dans la bibliothèque cliente.
  • MessagingEntityNotFound: une ressource Service Bus est introuvable par le service Service Bus.
  • MessageLockLost: le verrou sur le message est perdu. Les appelants doivent tenter de recevoir et de traiter à nouveau le message.
  • MessageNotFound: le message demandé n’a pas été trouvé.
  • MessageSizeExceededed: un message est supérieur à la taille maximale autorisée pour son transport.
  • MessagingEntityAlreadyExists: une entité portant le même nom existe sous le même espace de noms.
  • MessagingEntityDisabled: l’entité de messagerie est désactivée. Réactivez l’entité à l’aide du portail.
  • QuotaExceed: le quota appliqué à une ressource Service Bus a été dépassé lors de l’interaction avec le service Azure Service Bus.
  • ServiceBusy: le service Azure Service Bus signale qu’il est occupé en réponse à une demande cliente pour effectuer une opération.
  • ServiceTimeout: une opération ou une autre requête a expiré lors de l’interaction avec le service Azure Service Bus.
  • ServiceCommunicationProblem: une erreur de communication générale s’est produite lors de l’interaction avec le service Azure Service Bus.
  • SessionCannotBeLocked: la session demandée ne peut pas être verrouillée.
  • SessionLockLost: le verrou sur la session a expiré. Les appelants doivent demander à nouveau la session.
  • Non autoriséAccess : l’utilisateur n’a pas accès à l’entité.
code: ServiceBusErrorCode

Valeur de propriété

ServiceBusErrorCode

Détails de la propriété héritée

address

Adresse à laquelle la connexion réseau a échoué. Présente uniquement si la MessagingError a été instanciée avec un Node.js SystemError.

address?: string

Valeur de propriété

string

héritée deMessagingError.address

errno

Numéro d’erreur fourni par le système. Présente uniquement si la MessagingError a été instanciée avec un Node.js SystemError.

errno?: string | number

Valeur de propriété

string | number

héritée deMessagingError.errno

info

Détails supplémentaires sur l’erreur.

info?: any

Valeur de propriété

any

héritée deMessagingError.info

message 

message: string

Valeur de propriété

string

héritée deMessagingError.message

name

Nom de l’erreur. Valeur par défaut : « MessagingError ».

name: string

Valeur de propriété

string

héritée deMessagingError.name

port

Port de connexion réseau indisponible. Présente uniquement si la MessagingError a été instanciée avec un Node.js SystemError.

port?: number

Valeur de propriété

number

héritée deMessagingError.port

retryable

Décrit si l’erreur est retenable. Valeur par défaut : true.

retryable: boolean

Valeur de propriété

boolean

héritée deMessagingError.retryable

stack 

stack?: string

Valeur de propriété

string

héritée deMessagingError.stack

stackTraceLimit

La Error.stackTraceLimit propriété spécifie le nombre de trames de pile collectées par une trace de pile (qu’elle soit générée par new Error().stack ou Error.captureStackTrace(obj)).

La valeur par défaut est 10 mais peut être définie sur n’importe quel numéro JavaScript valide. Les modifications affecteront toute trace de pile capturée après la modification de la valeur.

S’ils sont définis sur une valeur non numérique ou sur un nombre négatif, les traces de pile ne captureront aucune trame.

static stackTraceLimit: number

Valeur de propriété

number

héritée deMessagingError.stackTraceLimit

syscall

Nom de l’appel système qui a déclenché l’erreur. Présente uniquement si la MessagingError a été instanciée avec un Node.js SystemError.

syscall?: string

Valeur de propriété

string

héritée deMessagingError.syscall

Détails de la méthode héritée

captureStackTrace(object, Function)

Crée une .stack propriété le , targetObjectqui, lorsqu’elle est accédée, renvoie une chaîne représentant l’emplacement dans le code auquel Error.captureStackTrace() a été appelé.

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

La première ligne de la trace sera préfixée par ${myObject.name}: ${myObject.message}.

L’argument facultatif constructorOpt accepte une fonction. Si cette option est donnée, toutes les images au-dessus constructorOptde , y compris constructorOpt, seront omises de la trace de pile générée.

L’argument constructorOpt est utile pour masquer à l’utilisateur les détails de l’implémentation de la génération d’erreurs. Par exemple:

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)

Paramètres

targetObject

object

constructorOpt

Function

héritée deMessagingError.captureStackTrace

prepareStackTrace(Error, CallSite[])

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

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

Paramètres

err

Error

stackTraces

CallSite[]

Retours

any

héritée deMessagingError.prepareStackTrace