مشاركة عبر

ServiceBusError class

الحزمة:
@azure/service-bus

الأخطاء التي تحدث داخل ناقل خدمة Microsoft Azure.

يمتد
MessagingError

المنشئون

ServiceBusError(MessagingError)
ServiceBusError(string, ServiceBusErrorCode)

الخصائص

code

سبب الفشل.

  • GeneralError: الاستثناء كان نتيجة خطأ عام داخل مكتبة العميل.
  • MessagingEntityNotFound: لا يمكن العثور على مورد ناقل خدمة Microsoft Azure بواسطة خدمة ناقل خدمة Microsoft Azure.
  • MessageLockLost: يتم فقدان التأمين على الرسالة. يجب أن يحاول المتصلون تلقي الرسالة ومعالجتها مرة أخرى.
  • MessageNotFound: لم يتم العثور على الرسالة المطلوبة.
  • MessageSizeExceeded: الرسالة أكبر من الحد الأقصى للحجم المسموح به لنقلها.
  • MessagingEntityAlreadyExists: يوجد كيان بنفس الاسم تحت نفس مساحة الاسم.
  • MessagingEntityDisabled: تم تعطيل "كيان المراسلة". تمكين الكيان مرة أخرى باستخدام المدخل.
  • QuotaExceeded: تم تجاوز الحصة النسبية المطبقة على مورد ناقل خدمة Microsoft Azure أثناء التفاعل مع خدمة ناقل خدمة Microsoft Azure.
  • ServiceBusy: تبلغ خدمة ناقل خدمة Microsoft Azure عن أنها مشغولة استجابة لطلب العميل لتنفيذ عملية.
  • ServiceTimeout: انتهت مهلة عملية أو طلب آخر أثناء التفاعل مع خدمة ناقل خدمة Azure.
  • ServiceCommunicationProblem: حدث خطأ في الاتصالات العامة عند التفاعل مع خدمة ناقل خدمة Microsoft Azure.
  • SessionCannotBeLocked: لا يمكن تأمين جلسة العمل المطلوبة.
  • SessionLockLost: انتهت صلاحية التأمين على جلسة العمل. يجب على المتصلين طلب جلسة العمل مرة أخرى.
  • UnauthorizedAccess": لا يملك المستخدم حق الوصول إلى الكيان.

الخصائص الموروثة

address

العنوان الذي فشل فيه اتصال الشبكة. موجود فقط إذا تم إنشاء مثيل MessagingError باستخدام Node.js SystemError.
errno

رقم الخطأ الذي يوفره النظام. موجود فقط إذا تم إنشاء مثيل MessagingError باستخدام Node.js SystemError.
info

تفاصيل إضافية حول الخطأ.
message
name

اسم الخطأ. القيمة الافتراضية: "MessagingError".
port

منفذ اتصال الشبكة غير المتوفر. موجود فقط إذا تم إنشاء مثيل MessagingError باستخدام Node.js SystemError.
retryable

يصف ما إذا كان الخطأ قابلا لإعادة المحاولة. الافتراضي: صحيح.
stack
stackTraceLimit

تحدد الخاصية Error.stackTraceLimit عدد إطارات المكدس التي تم تجميعها بواسطة تتبع مكدس (سواء تم إنشاؤها بواسطة new Error().stack أو Error.captureStackTrace(obj)).

القيمة الافتراضية هي 10 ولكن يمكن تعيينها إلى أي رقم JavaScript صالح. ستؤثر التغييرات على أي تتبع مكدس تم التقاطه بعد تغيير القيمة.

إذا تم تعيينها إلى قيمة غير رقمية، أو تم تعيينها على رقم سالب، فلن تلتقط تتبعات المكدس أي إطارات.
syscall

اسم استدعاء النظام الذي أدى إلى ظهور الخطأ. موجود فقط إذا تم إنشاء مثيل MessagingError باستخدام Node.js SystemError.

الأساليب المتوارثة

captureStackTrace(object, Function)

ينشئ خاصية .stack على targetObject، والتي عند الوصول إليها ترجع سلسلة تمثل الموقع في التعليمات البرمجية التي Error.captureStackTrace() تم استدعاؤها عنده.

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

سيتم مسبوق السطر الأول من التتبع ب ${myObject.name}: ${myObject.message}.

تقبل الوسيطة الاختيارية constructorOpt دالة. إذا تم إعطاؤها، حذف جميع الإطارات أعلاه constructorOpt، بما في ذلك constructorOpt، من تتبع المكدس الذي تم إنشاؤه.

الوسيطة constructorOpt مفيدة لإخفاء تفاصيل التنفيذ لإنشاء الخطأ عن المستخدم. على سبيل المثال،

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

راجع https://v8.dev/docs/stack-trace-api#customizing-stack-traces

تفاصيل المنشئ

ServiceBusError(MessagingError) 

new ServiceBusError(messagingError: MessagingError)

المعلمات

messagingError
MessagingError

خطأ سيتم نسخ خصائصه إلى ServiceBusError.

ServiceBusError(string, ServiceBusErrorCode) 

new ServiceBusError(message: string, code: ServiceBusErrorCode)

المعلمات

message

string

رسالة الخطأ التي توفر المزيد من المعلومات حول الخطأ.

code
ServiceBusErrorCode

سبب الفشل.

تفاصيل الخاصية

code

سبب الفشل.

  • GeneralError: الاستثناء كان نتيجة خطأ عام داخل مكتبة العميل.
  • MessagingEntityNotFound: لا يمكن العثور على مورد ناقل خدمة Microsoft Azure بواسطة خدمة ناقل خدمة Microsoft Azure.
  • MessageLockLost: يتم فقدان التأمين على الرسالة. يجب أن يحاول المتصلون تلقي الرسالة ومعالجتها مرة أخرى.
  • MessageNotFound: لم يتم العثور على الرسالة المطلوبة.
  • MessageSizeExceeded: الرسالة أكبر من الحد الأقصى للحجم المسموح به لنقلها.
  • MessagingEntityAlreadyExists: يوجد كيان بنفس الاسم تحت نفس مساحة الاسم.
  • MessagingEntityDisabled: تم تعطيل "كيان المراسلة". تمكين الكيان مرة أخرى باستخدام المدخل.
  • QuotaExceeded: تم تجاوز الحصة النسبية المطبقة على مورد ناقل خدمة Microsoft Azure أثناء التفاعل مع خدمة ناقل خدمة Microsoft Azure.
  • ServiceBusy: تبلغ خدمة ناقل خدمة Microsoft Azure عن أنها مشغولة استجابة لطلب العميل لتنفيذ عملية.
  • ServiceTimeout: انتهت مهلة عملية أو طلب آخر أثناء التفاعل مع خدمة ناقل خدمة Azure.
  • ServiceCommunicationProblem: حدث خطأ في الاتصالات العامة عند التفاعل مع خدمة ناقل خدمة Microsoft Azure.
  • SessionCannotBeLocked: لا يمكن تأمين جلسة العمل المطلوبة.
  • SessionLockLost: انتهت صلاحية التأمين على جلسة العمل. يجب على المتصلين طلب جلسة العمل مرة أخرى.
  • UnauthorizedAccess": لا يملك المستخدم حق الوصول إلى الكيان.
code: ServiceBusErrorCode

قيمة الخاصية

ServiceBusErrorCode

تفاصيل الخاصية الموروثة

address

العنوان الذي فشل فيه اتصال الشبكة. موجود فقط إذا تم إنشاء مثيل MessagingError باستخدام Node.js SystemError.

address?: string

قيمة الخاصية

string

موروث منMessagingError.address

errno

رقم الخطأ الذي يوفره النظام. موجود فقط إذا تم إنشاء مثيل MessagingError باستخدام Node.js SystemError.

errno?: string | number

قيمة الخاصية

string | number

موروث منMessagingError.errno

info

تفاصيل إضافية حول الخطأ.

info?: any

قيمة الخاصية

any

موروث منMessagingError.info

message 

message: string

قيمة الخاصية

string

موروث منMessagingError.message

name

اسم الخطأ. القيمة الافتراضية: "MessagingError".

name: string

قيمة الخاصية

string

موروث منMessagingError.name

port

منفذ اتصال الشبكة غير المتوفر. موجود فقط إذا تم إنشاء مثيل MessagingError باستخدام Node.js SystemError.

port?: number

قيمة الخاصية

number

موروث منMessagingError.port

retryable

يصف ما إذا كان الخطأ قابلا لإعادة المحاولة. الافتراضي: صحيح.

retryable: boolean

قيمة الخاصية

boolean

موروث منMessagingError.retryable

stack 

stack?: string

قيمة الخاصية

string

موروث منMessagingError.stack

stackTraceLimit

تحدد الخاصية Error.stackTraceLimit عدد إطارات المكدس التي تم تجميعها بواسطة تتبع مكدس (سواء تم إنشاؤها بواسطة new Error().stack أو Error.captureStackTrace(obj)).

القيمة الافتراضية هي 10 ولكن يمكن تعيينها إلى أي رقم JavaScript صالح. ستؤثر التغييرات على أي تتبع مكدس تم التقاطه بعد تغيير القيمة.

إذا تم تعيينها إلى قيمة غير رقمية، أو تم تعيينها على رقم سالب، فلن تلتقط تتبعات المكدس أي إطارات.

static stackTraceLimit: number

قيمة الخاصية

number

موروث منMessagingError.stackTraceLimit

syscall

اسم استدعاء النظام الذي أدى إلى ظهور الخطأ. موجود فقط إذا تم إنشاء مثيل MessagingError باستخدام Node.js SystemError.

syscall?: string

قيمة الخاصية

string

موروث منMessagingError.syscall

تفاصيل الأساليب المتوارثة

captureStackTrace(object, Function)

ينشئ خاصية .stack على targetObject، والتي عند الوصول إليها ترجع سلسلة تمثل الموقع في التعليمات البرمجية التي Error.captureStackTrace() تم استدعاؤها عنده.

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

سيتم مسبوق السطر الأول من التتبع ب ${myObject.name}: ${myObject.message}.

تقبل الوسيطة الاختيارية constructorOpt دالة. إذا تم إعطاؤها، حذف جميع الإطارات أعلاه constructorOpt، بما في ذلك constructorOpt، من تتبع المكدس الذي تم إنشاؤه.

الوسيطة constructorOpt مفيدة لإخفاء تفاصيل التنفيذ لإنشاء الخطأ عن المستخدم. على سبيل المثال،

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)

المعلمات

targetObject

object

constructorOpt

Function

موروث منMessagingError.captureStackTrace

prepareStackTrace(Error, CallSite[])

راجع https://v8.dev/docs/stack-trace-api#customizing-stack-traces

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

المعلمات

err

Error

stackTraces

CallSite[]

المرتجعات

any

موروث منMessagingError.prepareStackTrace