RestError class

الحزمة:
@azure/core-http

خطأ ناتج عن طلب HTTP إلى نقطة نهاية خدمة.

يمتد

Error

المنشئون

RestError(string, string, number, WebResourceLike, HttpOperationResponse)

الخصائص

code

رمز الخطأ، إن وجد. يمكن أن تكون إحدى خصائص رمز الخطأ الثابت (REQUEST_SEND_ERROR / PARSE_ERROR) أو يمكن أن تكون رمز سلسلة من استدعاء نظام أساسي (E_NOENT).
details

أي تفاصيل إضافية. في حالة أخطاء إلغاء التسلسل، يمكن أن تكون الاستجابة المعالجة.
PARSE_ERROR

سلسلة ثابتة لتحديد الأخطاء التي قد تنشأ من تحليل استجابة HTTP واردة. يشير عادة إلى نص HTTP مشوه، مثل حمولة JSON المشفرة غير المكتملة.
request

طلب صادر.
REQUEST_SEND_ERROR

سلسلة ثابتة لتحديد الأخطاء التي قد تنشأ عند إجراء طلب HTTP يشير إلى وجود مشكلة في طبقة النقل (على سبيل المثال، لا يمكن حل اسم مضيف عنوان URL عبر DNS.)
response

الاستجابة الواردة.
statusCode

رمز حالة HTTP للاستجابة، إذا تم إرجاع واحد.

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

message
name
stack
stackTraceLimit

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

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

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

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

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

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

RestError(string, string, number, WebResourceLike, HttpOperationResponse) 

new RestError(message: string, code?: string, statusCode?: number, request?: WebResourceLike, response?: HttpOperationResponse)

المعلمات

message

string

code

string

statusCode

number

request
WebResourceLike
response
HttpOperationResponse

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

code

رمز الخطأ، إن وجد. يمكن أن تكون إحدى خصائص رمز الخطأ الثابت (REQUEST_SEND_ERROR / PARSE_ERROR) أو يمكن أن تكون رمز سلسلة من استدعاء نظام أساسي (E_NOENT).

code?: string

قيمة الخاصية

string

details

أي تفاصيل إضافية. في حالة أخطاء إلغاء التسلسل، يمكن أن تكون الاستجابة المعالجة.

details?: unknown

قيمة الخاصية

unknown

PARSE_ERROR

سلسلة ثابتة لتحديد الأخطاء التي قد تنشأ من تحليل استجابة HTTP واردة. يشير عادة إلى نص HTTP مشوه، مثل حمولة JSON المشفرة غير المكتملة.

static PARSE_ERROR: string

قيمة الخاصية

string

request

طلب صادر.

request?: WebResourceLike

قيمة الخاصية

WebResourceLike

REQUEST_SEND_ERROR

سلسلة ثابتة لتحديد الأخطاء التي قد تنشأ عند إجراء طلب HTTP يشير إلى وجود مشكلة في طبقة النقل (على سبيل المثال، لا يمكن حل اسم مضيف عنوان URL عبر DNS.)

static REQUEST_SEND_ERROR: string

قيمة الخاصية

string

response

الاستجابة الواردة.

response?: HttpOperationResponse

قيمة الخاصية

HttpOperationResponse

statusCode

رمز حالة HTTP للاستجابة، إذا تم إرجاع واحد.

statusCode?: number

قيمة الخاصية

number

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

message 

message: string

قيمة الخاصية

string

موروثة من خطأ.message

name 

name: string

قيمة الخاصية

string

موروث من Error.name

stack 

stack?: string

قيمة الخاصية

string

موروث من Error.stack

stackTraceLimit

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

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

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

static stackTraceLimit: number

قيمة الخاصية

number

موروث من خطأ.stackTraceLimit

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

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

موروث من Error.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

موروث من خطأ.prepareStackTrace