Office.Error interface

Paquete:

office

Proporciona información específica sobre un error que se produjo durante una operación de datos asincrónica.

Comentarios

Se obtiene acceso al objeto Error desde el objeto AsyncResult que se devuelve en la función pasada como argumento de devolución de llamada de una operación de datos asincrónica, como el setSelectedDataAsync método del objeto Document.

Propiedades

code	Obtiene el código numérico del error. Para obtener una lista de códigos de error, consulte Códigos de error de la API de JavaScript para Office.
message	Obtiene una descripción detallada del error.
name	Obtiene el nombre del error.

Detalles de las propiedades

code

Obtiene el código numérico del error. Para obtener una lista de códigos de error, consulte Códigos de error de la API de JavaScript para Office.

code: number;

Valor de propiedad

number

Ejemplos

// 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

Obtiene una descripción detallada del error.

message: string;

Valor de propiedad

string

Ejemplos

// 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

Obtiene el nombre del error.

name: string;

Valor de propiedad

string

Ejemplos

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