CustomFunctions.ErrorCode enum

Pacote:
custom-functions-runtime

Códigos de erro para funções personalizadas. Os códigos de erro serão exibidos na célula que invocou a função.

Mensagens de erro personalizadas são exibidas além desses códigos de erro. As mensagens personalizadas são exibidas no menu indicador de erro, que é acessado passando o mouse sobre o sinalizador de erro em cada célula com erro.

Comentários

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]];
  };

Campos

divisionByZero = "#DIV/0!"

Esse código de erro indica que a função usada está se dividindo por zero ou células vazias. Uma mensagem de erro personalizada não pode ser usada.
invalidName = "#NAME?"

Esse código de erro indica que há um erro de digitação no nome da função. Observe que esse código de erro tem suporte como um erro de entrada de função personalizada, mas não como um erro de saída de função personalizada. Uma mensagem de erro personalizada não pode ser usada.
invalidNumber = "#NUM!"

Esse código de erro indica que há um problema com um número na função. Uma mensagem de erro personalizada não pode ser usada.
invalidReference = "#REF!"

Esse código de erro indica que a função se refere a uma célula inválida. Observe que esse código de erro tem suporte como um erro de entrada de função personalizada, mas não como um erro de saída de função personalizada. Uma mensagem de erro personalizada não pode ser usada.
invalidValue = "#VALUE!"

Esse código de erro indica que um valor na função é do tipo de dados errado. Uma mensagem de erro personalizada pode ser usada além do código de erro, se desejado.
notAvailable = "#N/A"

Esse código de erro indica que a função ou o serviço não está disponível. Uma mensagem de erro personalizada pode ser usada além do código de erro, se desejado.
nullReference = "#NULL!"

Esse código de erro indica que os intervalos na função não formam uma interseção. Uma mensagem de erro personalizada não pode ser usada.