CustomFunctions.Error class

Verwenden Sie diese Klasse, um Fehler zu behandeln und benutzerdefinierte Fehlermeldungen zu schreiben.

Hinweise

[ API-Satz: CustomFunctionsRuntime 1.2 ]

Beispiele

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

Konstruktoren

(constructor)(code, message)

Erstellt eine neue Instanz der Error -Klasse

Eigenschaften

code

Der von Ihrer benutzerdefinierten Funktion zurückgegebene Fehlercode.

message

Ihre benutzerdefinierte Fehlermeldung, z. B. "Dieser Aktienkurs ist nicht verfügbar". Benutzerdefinierte Meldungen sind nur mit bestimmten Fehlercodes verfügbar.

Details zum Konstruktor

(constructor)(code, message)

Erstellt eine neue Instanz der Error -Klasse

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

Parameter

message

string

Details zur Eigenschaft

code

Der von Ihrer benutzerdefinierten Funktion zurückgegebene Fehlercode.

code: ErrorCode;

Eigenschaftswert

Hinweise

[ API-Satz: CustomFunctionsRuntime 1.2 ]

message

Ihre benutzerdefinierte Fehlermeldung, z. B. "Dieser Aktienkurs ist nicht verfügbar". Benutzerdefinierte Meldungen sind nur mit bestimmten Fehlercodes verfügbar.

message?: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: CustomFunctionsRuntime 1.2 ]