RestError class

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

نوع خطأ مخصص لطلبات البنية الأساسية لبرنامج ربط العمليات التجارية الفاشلة.

يمتد: Error

المنشئون

الخصائص

code	رمز الخطأ نفسه (استخدم الثوابت على RestError إذا كان ذلك ممكنا.)
details	خاصية المكافأة التي تم تعيينها من قبل موقع الرمي.
PARSE_ERROR	وهذا يعني أن تحليل الاستجابة من الخادم فشل. ربما تم تكوينه بشكل غير جيد
request	الطلب الذي تم تقديمه.
REQUEST_SEND_ERROR	حدث خطأ ما عند تقديم الطلب. وهذا يعني فشل الطلب الفعلي لسبب ما، مثل مشكلة 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, RestErrorOptions)

new RestError(message: string, options?: RestErrorOptions)

المعلمات

message: string

options: RestErrorOptions

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

code

رمز الخطأ نفسه (استخدم الثوابت على RestError إذا كان ذلك ممكنا.)

code?: string

قيمة الخاصية

string

details

خاصية المكافأة التي تم تعيينها من قبل موقع الرمي.

details?: unknown

قيمة الخاصية

unknown

PARSE_ERROR

وهذا يعني أن تحليل الاستجابة من الخادم فشل. ربما تم تكوينه بشكل غير جيد

static PARSE_ERROR: string

قيمة الخاصية

string

request

الطلب الذي تم تقديمه.

request?: PipelineRequest

قيمة الخاصية

PipelineRequest

REQUEST_SEND_ERROR

حدث خطأ ما عند تقديم الطلب. وهذا يعني فشل الطلب الفعلي لسبب ما، مثل مشكلة DNS أو الاتصال الذي يتم فقدانه.

static REQUEST_SEND_ERROR: string

قيمة الخاصية

string

response

تم تلقي الاستجابة (إن وجدت.)

response?: PipelineResponse

قيمة الخاصية

PipelineResponse

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)

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

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

الوسيطة 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

الملاحظات

هل كانت هذه الصفحة مفيدة؟