@types/office-js 1.0.300 → 1.0.302

office-js/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for Office.js (https://github.com/OfficeD
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/office-js.
 
 ### Additional Details
- * Last updated: Mon, 14 Nov 2022 16:32:54 GMT
+ * Last updated: Thu, 01 Dec 2022 21:32:57 GMT
  * Dependencies: none
  * Global values: `Excel`, `Office`, `OfficeCore`, `OfficeExtension`, `OneNote`, `PowerPoint`, `Visio`, `Word`
 

office-js/index.d.ts

@@ -10233,13 +10233,12 @@ declare namespace Office {
          *
          * @param options - An object literal that contains one or more of the following properties:-
          *        `asyncContext`: Developers can provide any object they wish to access in the callback function.
-         * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter
-         *                             of type `Office.AsyncResult`.
-         *                 On success, the initialization context data is provided in the `asyncResult.value` property as a string.
-         *                 If there is no initialization context, the `asyncResult` object will contain
-         *                 an `Error` object with its `code` property set to 9020 and its `name` property set to `GenericResponseError`.
+         * @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter
+         *                 of type `Office.AsyncResult`.
+         *                 On success, the initialization context data is provided as a string (or an empty string if there's no initialization context)
+         *                 in the `asyncResult.value` property.
          */
-        getInitializationContextAsync(options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<string>) => void): void;
+        getInitializationContextAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<string>) => void): void;
         /**
          * Gets initialization data passed when the add-in is {@link https://learn.microsoft.com/outlook/actionable-messages/invoke-add-in | activated by an actionable message}.
          *
@@ -10250,13 +10249,12 @@ declare namespace Office {
          *
          * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Appointment Organizer
          *
-         * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter
-         *                             of type `Office.AsyncResult`.
-         *                 On success, the initialization context data is provided in the `asyncResult.value` property as a string.
-         *                 If there is no initialization context, the `asyncResult` object will contain
-         *                 an `Error` object with its `code` property set to 9020 and its `name` property set to `GenericResponseError`.
+         * @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter
+         *                 of type `Office.AsyncResult`.
+         *                 On success, the initialization context data is provided as a string (or an empty string if there's no initialization context)
+         *                 in the `asyncResult.value` property.
          */
-        getInitializationContextAsync(callback?: (asyncResult: Office.AsyncResult<string>) => void): void;
+        getInitializationContextAsync(callback: (asyncResult: Office.AsyncResult<string>) => void): void;
         /**
          * Asynchronously gets the ID of a saved item.
          *
@@ -11547,13 +11545,12 @@ declare namespace Office {
          *
          * @param options - An object literal that contains one or more of the following properties:-
          *        `asyncContext`: Developers can provide any object they wish to access in the callback function.
-         * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter
-         *                             of type `Office.AsyncResult`.
-         *                 On success, the initialization context data is provided in the `asyncResult.value` property as a string.
-         *                 If there is no initialization context, the `asyncResult` object will contain
-         *                 an `Error` object with its `code` property set to 9020 and its `name` property set to `GenericResponseError`.
+         * @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter
+         *                 of type `Office.AsyncResult`.
+         *                 On success, the initialization context data is provided as a string (or an empty string if there's no initialization context)
+         *                 in the `asyncResult.value` property.
          */
-        getInitializationContextAsync(options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<string>) => void): void;
+        getInitializationContextAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<string>) => void): void;
         /**
          * Gets initialization data passed when the add-in is {@link https://learn.microsoft.com/outlook/actionable-messages/invoke-add-in | activated by an actionable message}.
          *
@@ -11564,13 +11561,12 @@ declare namespace Office {
          *
          * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Appointment Attendee
          *
-         * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter
-         *                             of type `Office.AsyncResult`.
-         *                 On success, the initialization context data is provided in the `asyncResult.value` property as a string.
-         *                 If there is no initialization context, the `asyncResult` object will contain
-         *                 an `Error` object with its `code` property set to 9020 and its `name` property set to `GenericResponseError`.
+         * @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter
+         *                 of type `Office.AsyncResult`.
+         *                 On success, the initialization context data is provided as a string (or an empty string if there's no initialization context)
+         *                 in the `asyncResult.value` property.
          */
-        getInitializationContextAsync(callback?: (asyncResult: Office.AsyncResult<string>) => void): void;
+        getInitializationContextAsync(callback: (asyncResult: Office.AsyncResult<string>) => void): void;
         /**
          * Returns string values in the selected item that match the regular expressions defined in the manifest XML file.
          *
@@ -15280,13 +15276,12 @@ declare namespace Office {
          *
          * @param options - An object literal that contains one or more of the following properties:-
          *        `asyncContext`: Developers can provide any object they wish to access in the callback function.
-         * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter
-         *                             of type `Office.AsyncResult`.
-         *                 On success, the initialization context data is provided in the `asyncResult.value` property as a string.
-         *                 If there is no initialization context, the `asyncResult` object will contain
-         *                 an `Error` object with its `code` property set to 9020 and its `name` property set to `GenericResponseError`.
+         * @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter
+         *                 of type `Office.AsyncResult`.
+         *                 On success, the initialization context data is provided as a string (or an empty string if there's no initialization context)
+         *                 in the `asyncResult.value` property.
          */
-        getInitializationContextAsync(options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<string>) => void): void;
+        getInitializationContextAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<string>) => void): void;
         /**
          * Gets initialization data passed when the add-in is {@link https://learn.microsoft.com/outlook/actionable-messages/invoke-add-in | activated by an actionable message}.
          *
@@ -15297,13 +15292,12 @@ declare namespace Office {
          *
          * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Message Compose
          *
-         * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter
-         *                             of type `Office.AsyncResult`.
-         *                 On success, the initialization context data is provided in the `asyncResult.value` property as a string.
-         *                 If there is no initialization context, the `asyncResult` object will contain
-         *                 an `Error` object with its `code` property set to 9020 and its `name` property set to `GenericResponseError`.
+         * @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter
+         *                 of type `Office.AsyncResult`.
+         *                 On success, the initialization context data is provided as a string (or an empty string if there's no initialization context)
+         *                 in the `asyncResult.value` property.
          */
-        getInitializationContextAsync(callback?: (asyncResult: Office.AsyncResult<string>) => void): void;
+        getInitializationContextAsync(callback: (asyncResult: Office.AsyncResult<string>) => void): void;
         /**
          * Asynchronously gets the ID of a saved item.
          *
@@ -16528,13 +16522,12 @@ declare namespace Office {
          *
          * @param options - An object literal that contains one or more of the following properties:-
          *        `asyncContext`: Developers can provide any object they wish to access in the callback function.
-         * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter
-         *                             of type `Office.AsyncResult`.
-         *                 On success, the initialization context data is provided in the `asyncResult.value` property as a string.
-         *                 If there is no initialization context, the `asyncResult` object will contain
-         *                 an `Error` object with its `code` property set to 9020 and its `name` property set to `GenericResponseError`.
+         * @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter
+         *                 of type `Office.AsyncResult`.
+         *                 On success, the initialization context data is provided as a string (or an empty string if there's no initialization context)
+         *                 in the `asyncResult.value` property.
          */
-        getInitializationContextAsync(options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<string>) => void): void;
+        getInitializationContextAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<string>) => void): void;
         /**
          * Gets initialization data passed when the add-in is {@link https://learn.microsoft.com/outlook/actionable-messages/invoke-add-in | activated by an actionable message}.
          *
@@ -16545,13 +16538,12 @@ declare namespace Office {
          *
          * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Message Read
          *
-         * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter
-         *                             of type `Office.AsyncResult`.
-         *                 On success, the initialization context data is provided in the `asyncResult.value` property as a string.
-         *                 If there is no initialization context, the `asyncResult` object will contain
-         *                 an `Error` object with its `code` property set to 9020 and its `name` property set to `GenericResponseError`.
+         * @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter
+         *                 of type `Office.AsyncResult`.
+         *                 On success, the initialization context data is provided as a string (or an empty string if there's no initialization context)
+         *                 in the `asyncResult.value` property.
          */
-        getInitializationContextAsync(callback?: (asyncResult: Office.AsyncResult<string>) => void): void;
+        getInitializationContextAsync(callback: (asyncResult: Office.AsyncResult<string>) => void): void;
         /**
          * Returns string values in the selected item that match the regular expressions defined in the manifest XML file.
          *
@@ -33148,7 +33140,8 @@ declare namespace Excel {
          */
         readonly type: Excel.NamedItemType | "String" | "Integer" | "Double" | "Boolean" | "Range" | "Error" | "Array";
         /**
-         * Represents the value computed by the name's formula. For a named range, will return the range address.
+         * Represents the value computed by the name's formula. For a named range it will return the range address.
+         * Note: This API returns the #VALUE! error in the Excel UI if it refers to a custom function.
          *
          * @remarks
          * [Api set: ExcelApi 1.1]
@@ -66003,7 +65996,8 @@ declare namespace Excel {
              */
             type?: Excel.NamedItemType | "String" | "Integer" | "Double" | "Boolean" | "Range" | "Error" | "Array";
             /**
-             * Represents the value computed by the name's formula. For a named range, will return the range address.
+             * Represents the value computed by the name's formula. For a named range it will return the range address.
+             * Note: This API returns the #VALUE! error in the Excel UI if it refers to a custom function.
              *
              * @remarks
              * [Api set: ExcelApi 1.1]
@@ -72979,7 +72973,8 @@ declare namespace Excel {
              */
             type?: boolean;
             /**
-             * For EACH ITEM in the collection: Represents the value computed by the name's formula. For a named range, will return the range address.
+             * For EACH ITEM in the collection: Represents the value computed by the name's formula. For a named range it will return the range address.
+             * Note: This API returns the #VALUE! error in the Excel UI if it refers to a custom function.
              *
              * @remarks
              * [Api set: ExcelApi 1.1]
@@ -73080,7 +73075,8 @@ declare namespace Excel {
              */
             type?: boolean;
             /**
-             * Represents the value computed by the name's formula. For a named range, will return the range address.
+             * Represents the value computed by the name's formula. For a named range it will return the range address.
+             * Note: This API returns the #VALUE! error in the Excel UI if it refers to a custom function.
              *
              * @remarks
              * [Api set: ExcelApi 1.1]

office-js/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/office-js",
-    "version": "1.0.300",
+    "version": "1.0.302",
     "description": "TypeScript definitions for Office.js",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/office-js",
     "license": "MIT",
@@ -45,6 +45,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "32d8fcf891e6875e382f4d6e9f7c71ea1539f43a67bd352b6c2081a1594be476",
-    "typeScriptVersion": "4.1"
+    "typesPublisherContentHash": "6fcb2bd839b993fa3d03ed4ae08dd868c75af89f94ce9396adc109948b1a9797",
+    "typeScriptVersion": "4.2"
 }