@azure/core-util package

Interfaces

AbortOptions	Opções relacionadas ao controlador de abortamento.
CreateAbortablePromiseOptions	Opções para a função createAbortablePromise.
DelayOptions	As opções de suporte anulam a funcionalidade para o método de atraso

Aliases de Tipo

AbortablePromiseBuilder	Representa uma função que retorna uma promessa que pode ser anulada.
EncodingType	O tipo de codificação de caracteres suportado
HttpMethods	Métodos HTTP suportados para usar ao fazer solicitações.
UnknownObject	Uma forma genérica para um objeto JS simples.

Funções

calculateRetryDelay(number, { maxRetryDelayInMs: number, retryDelayInMs: number })	Calcula o intervalo de atraso para tentativas de repetição usando atraso exponencial com jitter.
cancelablePromiseRace<T>(AbortablePromiseBuilder<T[number]>[], { abortSignal?: AbortSignalLike })	invólucro promise.race() que aborta o resto das promessas assim que a primeira promessa se estabelece.
computeSha256Hash(string, "base64" | "hex")	Gera um hash SHA-256.
computeSha256Hmac(string, string, "base64" | "hex")	Gera uma assinatura HMAC SHA-256.
createAbortablePromise<T>((resolve: (value: T | PromiseLike<T>) => void, reject: (reason?: any) => void) => void, CreateAbortablePromiseOptions)	Cria uma promessa abortável.
delay(number, DelayOptions)	Um wrapper para setTimeout que resolve uma promessa após timeInMs milissegundos.
getErrorMessage(unknown)	Dado o que se pensa ser um objeto de erro, retorne a mensagem, se possível. Se a mensagem estiver ausente, retorna uma versão stringified da entrada.
getRandomIntegerInclusive(number, number)	Retorna um valor inteiro aleatório entre um limite inferior e superior, incluindo ambos os limites. Observe que isso usa Math.random e não é seguro. Se você precisa usar isso para qualquer tipo de finalidade de segurança, encontre uma fonte melhor de aleatório.
isDefined<T>(undefined | null | T)	Helper TypeGuard que verifica se algo está definido ou não.
isError(unknown)	Typeguard para uma forma de objeto de erro (tem nome e mensagem)
isObject(unknown)	Auxiliar para determinar quando uma entrada é um objeto JS genérico.
isObjectWithProperties<Thing, PropertyName>(Thing, PropertyName[])	Helper TypeGuard que verifica se a entrada é um objeto com as propriedades especificadas.
objectHasProperty<Thing, PropertyName>(Thing, PropertyName)	Helper TypeGuard que verifica se a entrada é um objeto com a propriedade especificada.
randomUUID()	Identificador universalmente único gerado
stringToUint8Array(string, EncodingType)	O auxiliar que transforma a cadeia de caracteres em matriz de bytes codificados por caracteres específicos.
uint8ArrayToString(Uint8Array, EncodingType)	O auxiliar que transforma bytes com codificação de caracteres específicos em cadeia de caracteres

Detalhes de Função

calculateRetryDelay(number, { maxRetryDelayInMs: number, retryDelayInMs: number })

Calcula o intervalo de atraso para tentativas de repetição usando atraso exponencial com jitter.

function calculateRetryDelay(retryAttempt: number, config: { maxRetryDelayInMs: number, retryDelayInMs: number }): { retryAfterInMs: number }

Parâmetros

retryAttempt

number

O número atual da tentativa de repetição.

config

{ maxRetryDelayInMs: number, retryDelayInMs: number }

A configuração de repetição exponencial.

Devoluções

{ retryAfterInMs: number }

Um objeto que contém o atraso de repetição calculado.

cancelablePromiseRace<T>(AbortablePromiseBuilder<T[number]>[], { abortSignal?: AbortSignalLike })

invólucro promise.race() que aborta o resto das promessas assim que a primeira promessa se estabelece.

function cancelablePromiseRace<T>(abortablePromiseBuilders: AbortablePromiseBuilder<T[number]>[], options?: { abortSignal?: AbortSignalLike }): Promise<T[number]>

Parâmetros

abortablePromiseBuilders

AbortablePromiseBuilder<T[number]>[]

options

{ abortSignal?: AbortSignalLike }

Devoluções

Promise<T[number]>

computeSha256Hash(string, "base64" | "hex")

Gera um hash SHA-256.

function computeSha256Hash(content: string, encoding: "base64" | "hex"): Promise<string>

Parâmetros

content

string

Os dados a serem incluídos no hash.

encoding

"base64" | "hex"

A codificação textual a ser usada para o hash retornado.

Devoluções

Promise<string>

computeSha256Hmac(string, string, "base64" | "hex")

Gera uma assinatura HMAC SHA-256.

function computeSha256Hmac(key: string, stringToSign: string, encoding: "base64" | "hex"): Promise<string>

Parâmetros

key

string

A chave HMAC representada como uma cadeia de caracteres base64, usada para gerar o hash HMAC criptográfico.

stringToSign

string

Os dados a assinar.

encoding

"base64" | "hex"

A codificação textual a ser usada para o resumo HMAC retornado.

Devoluções

Promise<string>

createAbortablePromise<T>((resolve: (value: T | PromiseLike<T>) => void, reject: (reason?: any) => void) => void, CreateAbortablePromiseOptions)

Cria uma promessa abortável.

function createAbortablePromise<T>(buildPromise: (resolve: (value: T | PromiseLike<T>) => void, reject: (reason?: any) => void) => void, options?: CreateAbortablePromiseOptions): Promise<T>

Parâmetros

buildPromise

(resolve: (value: T | PromiseLike<T>) => void, reject: (reason?: any) => void) => void

Uma função que usa as funções de resolução e rejeição como parâmetros.

options

CreateAbortablePromiseOptions

As opções para a promessa abortável.

Devoluções

Promise<T>

Uma promessa que pode ser abortada.

delay(number, DelayOptions)

Um wrapper para setTimeout que resolve uma promessa após timeInMs milissegundos.

function delay(timeInMs: number, options?: DelayOptions): Promise<void>

Parâmetros

timeInMs

number

O número de milissegundos a atrasar.

options

DelayOptions

As opções de atraso - opções atualmente abortadas

Devoluções

Promise<void>

Promessa que é resolvida após o tempoInMs

getErrorMessage(unknown)

Dado o que se pensa ser um objeto de erro, retorne a mensagem, se possível. Se a mensagem estiver ausente, retorna uma versão stringified da entrada.

function getErrorMessage(e: unknown): string

Parâmetros

e

unknown

Algo jogado de um bloco de tentativa

Devoluções

string

A mensagem de erro ou uma cadeia de caracteres da entrada

getRandomIntegerInclusive(number, number)

Retorna um valor inteiro aleatório entre um limite inferior e superior, incluindo ambos os limites. Observe que isso usa Math.random e não é seguro. Se você precisa usar isso para qualquer tipo de finalidade de segurança, encontre uma fonte melhor de aleatório.

function getRandomIntegerInclusive(min: number, max: number): number

Parâmetros

min

number

O menor valor inteiro permitido.

max

number

O maior valor inteiro permitido.

Devoluções

number

isDefined<T>(undefined | null | T)

Helper TypeGuard que verifica se algo está definido ou não.

function isDefined<T>(thing: undefined | null | T): thing

Parâmetros

thing

undefined | null | T

Qualquer coisa

Devoluções

thing

isError(unknown)

Typeguard para uma forma de objeto de erro (tem nome e mensagem)

function isError(e: unknown): e

Parâmetros

e

unknown

Algo apanhado por uma cláusula de captura.

Devoluções

e

isObject(unknown)

Auxiliar para determinar quando uma entrada é um objeto JS genérico.

function isObject(input: unknown): input

Parâmetros

input

unknown

Devoluções

input

true quando a entrada é um tipo de objeto que não é nulo, Array, RegExp ou Date.

isObjectWithProperties<Thing, PropertyName>(Thing, PropertyName[])

Helper TypeGuard que verifica se a entrada é um objeto com as propriedades especificadas.

function isObjectWithProperties<Thing, PropertyName>(thing: Thing, properties: PropertyName[]): thing

Parâmetros

thing

Thing

Qualquer coisa.

properties

PropertyName[]

O nome das propriedades que devem aparecer no objeto.

Devoluções

thing

objectHasProperty<Thing, PropertyName>(Thing, PropertyName)

Helper TypeGuard que verifica se a entrada é um objeto com a propriedade especificada.

function objectHasProperty<Thing, PropertyName>(thing: Thing, property: PropertyName): thing

Parâmetros

thing

Thing

Qualquer objeto.

property

PropertyName

O nome da propriedade que deve aparecer no objeto.

Devoluções

thing

randomUUID()

Identificador universalmente único gerado

function randomUUID(): string

Devoluções

string

RFC4122 v4 UUID.

stringToUint8Array(string, EncodingType)

O auxiliar que transforma a cadeia de caracteres em matriz de bytes codificados por caracteres específicos.

function stringToUint8Array(value: string, format: EncodingType): Uint8Array

Parâmetros

value

string

a cadeia de caracteres a ser convertida

format

EncodingType

o formato que usamos para decodificar o valor

Devoluções

Uint8Array

um uint8array

uint8ArrayToString(Uint8Array, EncodingType)

O auxiliar que transforma bytes com codificação de caracteres específicos em cadeia de caracteres

function uint8ArrayToString(bytes: Uint8Array, format: EncodingType): string

Parâmetros

bytes

Uint8Array

os bytes uint8array

format

EncodingType

o formato que usamos para codificar o byte

Devoluções

string

uma cadeia de caracteres da cadeia de caracteres codificada