CustomFunctions.ErrorCode enum

Коды ошибок для пользовательских функций. В ячейке, вызвавшей функцию, отобразятся коды ошибок.

В дополнение к этим кодам ошибок отображаются настраиваемые сообщения об ошибках. Пользовательские сообщения отображаются в меню индикатора ошибки, которое можно открыть, наведя курсор на флаг ошибки в каждой ячейке с ошибкой.

Комментарии

Примеры

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

Поля

divisionByZero = "#DIV/0!"

Этот код ошибки означает, что используемая функция делит на ноль или пустые ячейки. Пользовательское сообщение об ошибке использовать нельзя.

invalidName = "#NAME?"

Эта ошибка указывает на опечатку в имени функции. Обратите внимание, что этот код ошибки поддерживается как ошибка ввода пользовательской функции, но не как ошибка вывода пользовательской функции. Пользовательское сообщение об ошибке использовать нельзя.

invalidNumber = "#NUM!"

Этот код ошибки указывает на проблему с числом в функции. Пользовательское сообщение об ошибке использовать нельзя.

invalidReference = "#REF!"

Эта ошибка указывает на то, что функция ссылается на недопустимую ячейку. Обратите внимание, что этот код ошибки поддерживается как ошибка ввода пользовательской функции, но не как ошибка вывода пользовательской функции. Пользовательское сообщение об ошибке использовать нельзя.

invalidValue = "#VALUE!"

Этот код ошибки указывает на то, что значение в функции имеет неправильный тип данных. При желании в дополнение к коду ошибки можно использовать настраиваемое сообщение об ошибке.

notAvailable = "#N/A"

Этот код ошибки указывает на то, что функция или служба недоступна. При желании в дополнение к коду ошибки можно использовать настраиваемое сообщение об ошибке.

nullReference = "#NULL!"

Этот код ошибки означает, что диапазоны в функции не пересекаются. Пользовательское сообщение об ошибке использовать нельзя.