Compartir a través de

RestError class

Paquete:
@azure/core-https

Tipo de error personalizado para solicitudes de canalización con error.

Extends

Error

Constructores

RestError(string, RestErrorOptions)

Propiedades

code

El código del propio error (use statics en RestError si es posible).
details

Propiedad bonus establecida por el sitio de lanzamiento.
PARSE_ERROR

Esto significa que se produjo un error al analizar la respuesta del servidor. Es posible que haya sido mal formado.
request

Solicitud que se realizó.
REQUEST_SEND_ERROR

Algo salió mal al realizar la solicitud. Esto significa que se produjo un error en la solicitud real por algún motivo, como un problema dns o la conexión que se pierde.
response

La respuesta recibida (si existe).
statusCode

Código de estado HTTP de la solicitud (si procede).

Propiedades heredadas

message
name
stack
stackTraceLimit

La Error.stackTraceLimit propiedad especifica el número de marcos de pila recopilados por un seguimiento de pila (ya sea generado por new Error().stack o Error.captureStackTrace(obj)).

El valor predeterminado es 10 pero se puede establecer en cualquier número de JavaScript válido. Los cambios afectarán a cualquier seguimiento de pila capturado después de que se haya cambiado el valor.

Si se establece en un valor que no es un número, o se establece en un número negativo, los seguimientos de pila no capturarán ningún fotograma.

Métodos heredados

captureStackTrace(object, Function)

Crea una .stack propiedad en targetObject, que, cuando se tiene acceso, devuelve una cadena que representa la ubicación en el código en el que Error.captureStackTrace() se llamó.

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

La primera línea de la traza tendrá el prefijo ${myObject.name}: ${myObject.message}.

El argumento opcional constructorOpt acepta una función. Si se proporciona, todos los fotogramas anteriores constructorOpt, incluido constructorOpt, se omitirán del seguimiento de pila generado.

El constructorOpt argumento es útil para ocultar al usuario los detalles de implementación de la generación de errores. Por ejemplo:

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

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

Detalles del constructor

RestError(string, RestErrorOptions) 

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

Parámetros

message

string

options
RestErrorOptions

Detalles de las propiedades

code

El código del propio error (use statics en RestError si es posible).

code?: string

Valor de propiedad

string

details

Propiedad bonus establecida por el sitio de lanzamiento.

details?: unknown

Valor de propiedad

unknown

PARSE_ERROR

Esto significa que se produjo un error al analizar la respuesta del servidor. Es posible que haya sido mal formado.

static PARSE_ERROR: string

Valor de propiedad

string

request

Solicitud que se realizó.

request?: PipelineRequest

Valor de propiedad

PipelineRequest

REQUEST_SEND_ERROR

Algo salió mal al realizar la solicitud. Esto significa que se produjo un error en la solicitud real por algún motivo, como un problema dns o la conexión que se pierde.

static REQUEST_SEND_ERROR: string

Valor de propiedad

string

response

La respuesta recibida (si existe).

response?: PipelineResponse

Valor de propiedad

PipelineResponse

statusCode

Código de estado HTTP de la solicitud (si procede).

statusCode?: number

Valor de propiedad

number

Detalles de las propiedades heredadas

message 

message: string

Valor de propiedad

string

Heredado de Error.message

name 

name: string

Valor de propiedad

string

heredado de Error.name

stack 

stack?: string

Valor de propiedad

string

heredado de Error.stack

stackTraceLimit

La Error.stackTraceLimit propiedad especifica el número de marcos de pila recopilados por un seguimiento de pila (ya sea generado por new Error().stack o Error.captureStackTrace(obj)).

El valor predeterminado es 10 pero se puede establecer en cualquier número de JavaScript válido. Los cambios afectarán a cualquier seguimiento de pila capturado después de que se haya cambiado el valor.

Si se establece en un valor que no es un número, o se establece en un número negativo, los seguimientos de pila no capturarán ningún fotograma.

static stackTraceLimit: number

Valor de propiedad

number

heredado de Error.stackTraceLimit

Detalles de los métodos heredados

captureStackTrace(object, Function)

Crea una .stack propiedad en targetObject, que, cuando se tiene acceso, devuelve una cadena que representa la ubicación en el código en el que Error.captureStackTrace() se llamó.

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

La primera línea de la traza tendrá el prefijo ${myObject.name}: ${myObject.message}.

El argumento opcional constructorOpt acepta una función. Si se proporciona, todos los fotogramas anteriores constructorOpt, incluido constructorOpt, se omitirán del seguimiento de pila generado.

El constructorOpt argumento es útil para ocultar al usuario los detalles de implementación de la generación de errores. Por ejemplo:

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)

Parámetros

targetObject

object

constructorOpt

Function

heredado de Error.captureStackTrace

prepareStackTrace(Error, CallSite[])

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

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

Parámetros

err

Error

stackTraces

CallSite[]

Devoluciones

any

heredado de Error.prepareStackTrace