Compartilhar via


CustomFunctions.Error class

Utilize esta classe para processar erros e escrever mensagens de erro personalizadas.

Comentários

[ Conjunto de API: CustomFunctionsRuntime 1.2 ]

Exemplos

/**
 * Returns the #NUM! error as part of a 2-dimensional array.
 * @customfunction
 * @param {number} first First parameter.
 * @param {number} second Second parameter.
 * @param {number} third Third parameter.
 * @returns {number[][]} Three results, as a 2-dimensional array.
 */
function returnInvalidNumberError(first, second, third) {
  // Use the `CustomFunctions.Error` object to retrieve an invalid number error.
  const error = new CustomFunctions.Error(
    CustomFunctions.ErrorCode.invalidNumber, // Corresponds to the #NUM! error in the Excel UI.
  );

  // Enter logic that processes the first, second, and third input parameters.
  // Imagine that the second calculation results in an invalid number error.
  const firstResult = first;
  const secondResult = error;
  const thirdResult = third;

  // Return the results of the first and third parameter calculations
  // and a #NUM! error in place of the second result.
  return [[firstResult], [secondResult], [thirdResult]];
};

Construtores

(constructor)(code, message)

Constrói uma nova instância da Error classe

Propriedades

code

O código de erro devolvido pela sua função personalizada.

message

A sua mensagem de erro personalizada, como "Este preço de ações está indisponível". As mensagens personalizadas só estão disponíveis com determinados códigos de erro.

Detalhes do construtor

(constructor)(code, message)

Constrói uma nova instância da Error classe

constructor(code: ErrorCode, message?: string);

Parâmetros

message

string

Detalhes da propriedade

code

O código de erro devolvido pela sua função personalizada.

code: ErrorCode;

Valor da propriedade

Comentários

[ Conjunto de API: CustomFunctionsRuntime 1.2 ]

message

A sua mensagem de erro personalizada, como "Este preço de ações está indisponível". As mensagens personalizadas só estão disponíveis com determinados códigos de erro.

message?: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: CustomFunctionsRuntime 1.2 ]