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 retourné dans la fonction passée en tant qu’argument de rappel d’une opération de données asynchrone, telle que la setSelectedDataAsync méthode de l’objet Document.

Propriétés

code	Obtient le code numérique de l’erreur. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur de l’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, consultez Codes d’erreur de l’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 === "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 === "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 === "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; 
}