Bagikan melalui

RestError class

Paket:
@azure/core-http

Kesalahan yang dihasilkan dari permintaan HTTP ke titik akhir layanan.

Memperluas

Error

Konstruktor

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

Properti

code

Kode kesalahan, jika ada. Dapat berupa salah satu properti kode kesalahan statis (REQUEST_SEND_ERROR /PARSE_ERROR) atau dapat menjadi kode string dari panggilan sistem yang mendasar (E_NOENT).
details

Detail tambahan apa pun. Dalam kasus kesalahan deserialisasi, dapat menjadi respons yang diproses.
PARSE_ERROR

String konstanta untuk mengidentifikasi kesalahan yang mungkin timbul dari penguraian respons HTTP masuk. Biasanya menunjukkan bodi HTTP cacat, seperti payload JSON yang dikodekan yang tidak lengkap.
request

Permintaan keluar.
REQUEST_SEND_ERROR

String konstanta untuk mengidentifikasi kesalahan yang mungkin muncul saat membuat permintaan HTTP yang menunjukkan masalah dengan lapisan transportasi (misalnya nama host URL tidak dapat diselesaikan melalui DNS.)
response

Respons masuk.
statusCode

Kode status HTTP respons, jika satu dikembalikan.

Properti yang Diwariskan

message
name
stack
stackTraceLimit

Properti menentukan Error.stackTraceLimit jumlah bingkai tumpukan yang dikumpulkan oleh pelacakan tumpukan (baik yang dihasilkan oleh new Error().stack atau Error.captureStackTrace(obj)).

Nilai defaultnya adalah 10 tetapi dapat diatur ke nomor JavaScript yang valid. Perubahan akan memengaruhi pelacakan tumpukan apa pun yang diambil setelah nilai diubah.

Jika diatur ke nilai non-angka, atau diatur ke angka negatif, pelacakan tumpukan tidak akan menangkap bingkai apa pun.

Metode yang Diwarisi

captureStackTrace(object, Function)

Membuat .stack properti pada targetObject, yang ketika diakses mengembalikan string yang mewakili lokasi dalam kode tempat Error.captureStackTrace() dipanggil.

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

Baris pertama jejak akan diawali dengan ${myObject.name}: ${myObject.message}.

Argumen opsional constructorOpt menerima fungsi. Jika diberikan, semua bingkai di atas constructorOpt, termasuk constructorOpt, akan dihilangkan dari jejak tumpukan yang dihasilkan.

Argumen ini constructorOpt berguna untuk menyembunyikan detail implementasi pembuatan kesalahan dari pengguna. Misalnya:

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

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

Detail Konstruktor

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

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

Parameter

message

string

code

string

statusCode

number

request
WebResourceLike
response
HttpOperationResponse

Detail Properti

code

Kode kesalahan, jika ada. Dapat berupa salah satu properti kode kesalahan statis (REQUEST_SEND_ERROR /PARSE_ERROR) atau dapat menjadi kode string dari panggilan sistem yang mendasar (E_NOENT).

code?: string

Nilai Properti

string

details

Detail tambahan apa pun. Dalam kasus kesalahan deserialisasi, dapat menjadi respons yang diproses.

details?: unknown

Nilai Properti

unknown

PARSE_ERROR

String konstanta untuk mengidentifikasi kesalahan yang mungkin timbul dari penguraian respons HTTP masuk. Biasanya menunjukkan bodi HTTP cacat, seperti payload JSON yang dikodekan yang tidak lengkap.

static PARSE_ERROR: string

Nilai Properti

string

request

Permintaan keluar.

request?: WebResourceLike

Nilai Properti

WebResourceLike

REQUEST_SEND_ERROR

String konstanta untuk mengidentifikasi kesalahan yang mungkin muncul saat membuat permintaan HTTP yang menunjukkan masalah dengan lapisan transportasi (misalnya nama host URL tidak dapat diselesaikan melalui DNS.)

static REQUEST_SEND_ERROR: string

Nilai Properti

string

response

Respons masuk.

response?: HttpOperationResponse

Nilai Properti

HttpOperationResponse

statusCode

Kode status HTTP respons, jika satu dikembalikan.

statusCode?: number

Nilai Properti

number

Detail Properti yang Diwariskan

message 

message: string

Nilai Properti

string

Diwariskan Dari Error.message

name 

name: string

Nilai Properti

string

Diwariskan Dari Error.name

stack 

stack?: string

Nilai Properti

string

Diwariskan Dari Error.stack

stackTraceLimit

Properti menentukan Error.stackTraceLimit jumlah bingkai tumpukan yang dikumpulkan oleh pelacakan tumpukan (baik yang dihasilkan oleh new Error().stack atau Error.captureStackTrace(obj)).

Nilai defaultnya adalah 10 tetapi dapat diatur ke nomor JavaScript yang valid. Perubahan akan memengaruhi pelacakan tumpukan apa pun yang diambil setelah nilai diubah.

Jika diatur ke nilai non-angka, atau diatur ke angka negatif, pelacakan tumpukan tidak akan menangkap bingkai apa pun.

static stackTraceLimit: number

Nilai Properti

number

Diwarisi Dari Error.stackTraceLimit

Detail Metode yang Diwarisi

captureStackTrace(object, Function)

Membuat .stack properti pada targetObject, yang ketika diakses mengembalikan string yang mewakili lokasi dalam kode tempat Error.captureStackTrace() dipanggil.

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

Baris pertama jejak akan diawali dengan ${myObject.name}: ${myObject.message}.

Argumen opsional constructorOpt menerima fungsi. Jika diberikan, semua bingkai di atas constructorOpt, termasuk constructorOpt, akan dihilangkan dari jejak tumpukan yang dihasilkan.

Argumen ini constructorOpt berguna untuk menyembunyikan detail implementasi pembuatan kesalahan dari pengguna. Misalnya:

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)

Parameter

targetObject

object

constructorOpt

Function

Diwarisi Dari Error.captureStackTrace

prepareStackTrace(Error, CallSite[])

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

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

Parameter

err

Error

stackTraces

CallSite[]

Mengembalikan

any

Diwarisi Dari Error.prepareStackTrace