Office.Error interface

Paquet:
office

Fournit des informations spécifiques sur une erreur qui s’est produite pendant une opération de données asynchrone.

Remarques

L’objet Error est accessible à partir de l’objet AsyncResult qui est renvoyé dans la fonction passée comme argument de rappel d’une opération de données asynchrones, telle que la setSelectedDataAsync méthode de l’objet Document.

Utilisateur

Propriétés

code

Obtient le code numérique de l’erreur. Pour obtenir la liste des codes d’erreur, voir Codes d’erreur API JavaScript pour Office.
message

Obtient une description détaillée de l’erreur.
name

Obtient le nom de l’erreur.

Détails de la propriété

code

Obtient le code numérique de l’erreur. Pour obtenir la liste des codes d’erreur, voir Codes d’erreur API JavaScript pour Office.

code: number;

Valeur de propriété

number

Exemples

// To cause an error to be thrown, select a table or a matrix, and then call the setText function.
function setText() {
    Office.context.document.setSelectedDataAsync("Hello World!",
        function (asyncResult) {
            if (asyncResult.status === Office.AsyncResultStatus.Failed) {
                const error = asyncResult.error;
                write(error.name + ": " + error.code + " - " + error.message);
            }
        });
}

// Function that writes to a div with id='message' on the page.
function write(message) {
    document.getElementById('message').innerText += message;
}

message

Obtient une description détaillée de l’erreur.

message: string;

Valeur de propriété

string

Exemples

// To cause an error to be thrown, select a table or a matrix, and then call the setText function.
function setText() {
    Office.context.document.setSelectedDataAsync("Hello World!",
        function (asyncResult) {
            if (asyncResult.status === Office.AsyncResultStatus.Failed) {
                const error = asyncResult.error;
                write(error.name + ": " + error.message);
            }
        });
}

// Function that writes to a div with id='message' on the page.
function write(message) {
    document.getElementById('message').innerText += message;
}

name

Obtient le nom de l’erreur.

name: string;

Valeur de propriété

string

Exemples

// To cause an error to be thrown, select a table or a matrix, and then call the setText function.
function setText() {
    Office.context.document.setSelectedDataAsync("Hello World!",
        function (asyncResult) {
            if (asyncResult.status === Office.AsyncResultStatus.Failed) {
                const error = asyncResult.error;
                write(error.name + ": " + error.message);
            }
        });
}

// Function that writes to a div with id='message' on the page.
function write(message) {
    document.getElementById('message').innerText += message;
}