@types/office-js-preview 1.0.687 → 1.0.688

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -8,7 +8,7 @@ This package contains type definitions for office-js-preview (https://github.com
8
8
  Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/office-js-preview.
9
9
 
10
10
  ### Additional Details
11
- * Last updated: Mon, 23 Feb 2026 19:24:54 GMT
11
+ * Last updated: Tue, 24 Feb 2026 16:50:23 GMT
12
12
  * Dependencies: none
13
13
 
14
14
  # Credits
@@ -7922,17 +7922,17 @@ declare namespace Office {
7922
7922
  */
7923
7923
  interface Settings {
7924
7924
  /**
7925
- * Adds an event handler for the settingsChanged event.
7925
+ * Adds an event handler for the `settingsChanged` event.
7926
7926
  *
7927
- * **Important**: Your add-in's code can register a handler for the settingsChanged event when the add-in is running with any Excel client, but
7927
+ * **Important**: Your add-in's code can register a handler for the `settingsChanged` event when the add-in is running with any Excel client, but
7928
7928
  * the event will fire only when the add-in is loaded with a spreadsheet that is opened in Excel on the web, and more than one user is editing the
7929
- * spreadsheet (coauthoring). Therefore, effectively the settingsChanged event is supported only in Excel on the web in coauthoring scenarios.
7929
+ * spreadsheet (coauthoring). Therefore, effectively the `settingsChanged` event is supported only in Excel on the web in coauthoring scenarios.
7930
7930
  *
7931
7931
  * @remarks
7932
7932
  *
7933
7933
  * **Requirement set**: {@link https://learn.microsoft.com/javascript/api/requirement-sets/common/office-add-in-requirement-sets#methods-that-arent-part-of-a-requirement-set | Not in a set}
7934
7934
  *
7935
- * You can add multiple event handlers for the specified eventType as long as the name of each event handler function is unique.
7935
+ * You can add multiple event handlers for the specified `eventType` as long as the name of each event handler function is unique.
7936
7936
  *
7937
7937
  * @param eventType Specifies the type of event to add. Required.
7938
7938
  * @param handler The event handler function to add, whose only parameter is of type {@link Office.SettingsChangedEventArgs}. Required.
@@ -7954,27 +7954,27 @@ declare namespace Office {
7954
7954
  * </tr>
7955
7955
  * <tr>
7956
7956
  * <td><code>AsyncResult.error</code></td>
7957
- * <td>Access an Error object that provides error information if the operation failed.</td>
7957
+ * <td>Access an <code>Error</code> object that provides error information if the operation failed.</td>
7958
7958
  * </tr>
7959
7959
  * <tr>
7960
7960
  * <td><code>AsyncResult.asyncContext</code></td>
7961
- * <td>Define an item of any type that's returned in the AsyncResult object without being altered.</td>
7961
+ * <td>Define an item of any type that's returned in the <code>AsyncResult</code> object without being altered.</td>
7962
7962
  * </tr>
7963
7963
  * </table>
7964
7964
  */
7965
7965
  addHandlerAsync(eventType: Office.EventType, handler: any, options?: Office.AsyncContextOptions, callback?: (result: AsyncResult<void>) => void): void;
7966
7966
  /**
7967
- * Adds an event handler for the settingsChanged event.
7967
+ * Adds an event handler for the `settingsChanged` event.
7968
7968
  *
7969
- * **Important**: Your add-in's code can register a handler for the settingsChanged event when the add-in is running with any Excel client, but
7969
+ * **Important**: Your add-in's code can register a handler for the `settingsChanged` event when the add-in is running with any Excel client, but
7970
7970
  * the event will fire only when the add-in is loaded with a spreadsheet that is opened in Excel on the web, and more than one user is editing the
7971
- * spreadsheet (coauthoring). Therefore, effectively the settingsChanged event is supported only in Excel on the web in coauthoring scenarios.
7971
+ * spreadsheet (coauthoring). Therefore, effectively the `settingsChanged` event is supported only in Excel on the web in coauthoring scenarios.
7972
7972
  *
7973
7973
  * @remarks
7974
7974
  *
7975
7975
  * **Requirement set**: {@link https://learn.microsoft.com/javascript/api/requirement-sets/common/office-add-in-requirement-sets#methods-that-arent-part-of-a-requirement-set | Not in a set}
7976
7976
  *
7977
- * You can add multiple event handlers for the specified eventType as long as the name of each event handler function is unique.
7977
+ * You can add multiple event handlers for the specified `eventType` as long as the name of each event handler function is unique.
7978
7978
  *
7979
7979
  * @param eventType Specifies the type of event to add. Required.
7980
7980
  * @param handler The event handler function to add, whose only parameter is of type {@link Office.SettingsChangedEventArgs}. Required.
@@ -7995,11 +7995,11 @@ declare namespace Office {
7995
7995
  * </tr>
7996
7996
  * <tr>
7997
7997
  * <td><code>AsyncResult.error</code></td>
7998
- * <td>Access an Error object that provides error information if the operation failed.</td>
7998
+ * <td>Access an <code>Error</code> object that provides error information if the operation failed.</td>
7999
7999
  * </tr>
8000
8000
  * <tr>
8001
8001
  * <td><code>AsyncResult.asyncContext</code></td>
8002
- * <td>Define an item of any type that's returned in the AsyncResult object without being altered.</td>
8002
+ * <td>Define an item of any type that's returned in the <code>AsyncResult</code> object without being altered.</td>
8003
8003
  * </tr>
8004
8004
  * </table>
8005
8005
  */
@@ -8025,10 +8025,10 @@ declare namespace Office {
8025
8025
  * This method is useful in Excel, Word, and PowerPoint coauthoring scenarios when multiple instances of the same add-in are working against
8026
8026
  * the same document. Because each add-in is working against an in-memory copy of the settings loaded from the document at the time the user
8027
8027
  * opened it, the settings values used by each user can get out of sync. This can happen whenever an instance of the add-in calls the
8028
- * Settings.saveAsync method to persist all of that user's settings to the document. Calling the refreshAsync method from the event handler
8029
- * for the settingsChanged event of the add-in will refresh the settings values for all users.
8028
+ * `Settings.saveAsync` method to persist all of that user's settings to the document. Calling the `refreshAsync` method from the event handler
8029
+ * for the `settingsChanged` event of the add-in will refresh the settings values for all users.
8030
8030
  *
8031
- * In the callback function passed to the refreshAsync method, you can use the properties of the AsyncResult object to return the following
8031
+ * In the callback function passed to the `refreshAsync` method, you can use the properties of the `AsyncResult` object to return the following
8032
8032
  * information.
8033
8033
  *
8034
8034
  * <table>
@@ -8038,7 +8038,7 @@ declare namespace Office {
8038
8038
  * </tr>
8039
8039
  * <tr>
8040
8040
  * <td><code>AsyncResult.value</code></td>
8041
- * <td>Access a Settings object with the refreshed values.</td>
8041
+ * <td>Access a <code>Settings</code> object with the refreshed values.</td>
8042
8042
  * </tr>
8043
8043
  * <tr>
8044
8044
  * <td><code>AsyncResult.status</code></td>
@@ -8046,11 +8046,11 @@ declare namespace Office {
8046
8046
  * </tr>
8047
8047
  * <tr>
8048
8048
  * <td><code>AsyncResult.error</code></td>
8049
- * <td>Access an Error object that provides error information if the operation failed.</td>
8049
+ * <td>Access an <code>Error</code> object that provides error information if the operation failed.</td>
8050
8050
  * </tr>
8051
8051
  * <tr>
8052
8052
  * <td><code>AsyncResult.asyncContext</code></td>
8053
- * <td>Define an item of any type that's returned in the AsyncResult object without being altered.</td>
8053
+ * <td>Define an item of any type that's returned in the <code>AsyncResult</code> object without being altered.</td>
8054
8054
  * </tr>
8055
8055
  * </table>
8056
8056
  *
@@ -8061,33 +8061,33 @@ declare namespace Office {
8061
8061
  /**
8062
8062
  * Removes the specified setting.
8063
8063
  *
8064
- * **Important**: Be aware that the Settings.remove method affects only the in-memory copy of the settings property bag. To persist the removal of
8065
- * the specified setting in the document, at some point after calling the Settings.remove method and before the add-in is closed, you must
8066
- * call the Settings.saveAsync method.
8064
+ * **Important**: Be aware that the `Settings.remove` method affects only the in-memory copy of the settings property bag. To persist the removal of
8065
+ * the specified setting in the document, at some point after calling the `Settings.remove` method and before the add-in is closed, you must
8066
+ * call the `Settings.saveAsync` method.
8067
8067
  *
8068
8068
  * @remarks
8069
8069
  *
8070
8070
  * **Requirement set**: {@link https://learn.microsoft.com/javascript/api/requirement-sets/common/office-add-in-requirement-sets#settings | Settings}
8071
8071
  *
8072
- * null is a valid value for a setting. Therefore, assigning null to the setting will not remove it from the settings property bag.
8072
+ * `null` is a valid value for a setting. Therefore, assigning `null` to the setting will not remove it from the settings property bag.
8073
8073
  *
8074
8074
  * @param settingName The case-sensitive name of the setting to remove.
8075
8075
  */
8076
8076
  remove(name: string): void;
8077
8077
  /**
8078
- * Removes an event handler for the settingsChanged event.
8078
+ * Removes an event handler for the `settingsChanged` event.
8079
8079
  *
8080
8080
  * @remarks
8081
8081
  *
8082
8082
  * **Requirement set**: {@link https://learn.microsoft.com/javascript/api/requirement-sets/common/office-add-in-requirement-sets#methods-that-arent-part-of-a-requirement-set | Not in a set}
8083
8083
  *
8084
- * If the optional handler parameter is omitted when calling the removeHandlerAsync method, all event handlers for the specified eventType
8084
+ * If the optional handler parameter is omitted when calling the `removeHandlerAsync` method, all event handlers for the specified `eventType`
8085
8085
  * will be removed.
8086
8086
  *
8087
- * When the function you passed to the callback parameter executes, it receives an AsyncResult object that you can access from the callback
8087
+ * When the function you passed to the callback parameter executes, it receives an `AsyncResult` object that you can access from the callback
8088
8088
  * function's only parameter.
8089
8089
  *
8090
- * In the callback function passed to the removeHandlerAsync method, you can use the properties of the AsyncResult object to return the
8090
+ * In the callback function passed to the `removeHandlerAsync` method, you can use the properties of the `AsyncResult` object to return the
8091
8091
  * following information.
8092
8092
  *
8093
8093
  * <table>
@@ -8105,11 +8105,11 @@ declare namespace Office {
8105
8105
  * </tr>
8106
8106
  * <tr>
8107
8107
  * <td><code>AsyncResult.error</code></td>
8108
- * <td>Access an Error object that provides error information if the operation failed.</td>
8108
+ * <td>Access an <code>Error</code> object that provides error information if the operation failed.</td>
8109
8109
  * </tr>
8110
8110
  * <tr>
8111
8111
  * <td><code>AsyncResult.asyncContext</code></td>
8112
- * <td>Define an item of any type that's returned in the AsyncResult object without being altered.</td>
8112
+ * <td>Define an item of any type that's returned in the <code>AsyncResult</code> object without being altered.</td>
8113
8113
  * </tr>
8114
8114
  * </table>
8115
8115
  *
@@ -8119,19 +8119,19 @@ declare namespace Office {
8119
8119
  */
8120
8120
  removeHandlerAsync(eventType: Office.EventType, options?: RemoveHandlerOptions, callback?: (result: AsyncResult<void>) => void): void;
8121
8121
  /**
8122
- * Removes an event handler for the settingsChanged event.
8122
+ * Removes an event handler for the `settingsChanged` event.
8123
8123
  *
8124
8124
  * @remarks
8125
8125
  *
8126
8126
  * **Requirement set**: {@link https://learn.microsoft.com/javascript/api/requirement-sets/common/office-add-in-requirement-sets#methods-that-arent-part-of-a-requirement-set | Not in a set}
8127
8127
  *
8128
- * If the optional handler parameter is omitted when calling the removeHandlerAsync method, all event handlers for the specified eventType
8128
+ * If the optional handler parameter is omitted when calling the `removeHandlerAsync` method, all event handlers for the specified `eventType`
8129
8129
  * will be removed.
8130
8130
  *
8131
- * When the function you passed to the callback parameter executes, it receives an AsyncResult object that you can access from the callback
8131
+ * When the function you passed to the callback parameter executes, it receives an `AsyncResult` object that you can access from the callback
8132
8132
  * function's only parameter.
8133
8133
  *
8134
- * In the callback function passed to the removeHandlerAsync method, you can use the properties of the AsyncResult object to return the
8134
+ * In the callback function passed to the `removeHandlerAsync` method, you can use the properties of the `AsyncResult` object to return the
8135
8135
  * following information.
8136
8136
  *
8137
8137
  * <table>
@@ -8149,11 +8149,11 @@ declare namespace Office {
8149
8149
  * </tr>
8150
8150
  * <tr>
8151
8151
  * <td><code>AsyncResult.error</code></td>
8152
- * <td>Access an Error object that provides error information if the operation failed.</td>
8152
+ * <td>Access an <code>Error</code> object that provides error information if the operation failed.</td>
8153
8153
  * </tr>
8154
8154
  * <tr>
8155
8155
  * <td><code>AsyncResult.asyncContext</code></td>
8156
- * <td>Define an item of any type that's returned in the AsyncResult object without being altered.</td>
8156
+ * <td>Define an item of any type that's returned in the <code>AsyncResult</code> object without being altered.</td>
8157
8157
  * </tr>
8158
8158
  * </table>
8159
8159
  *
@@ -8169,11 +8169,11 @@ declare namespace Office {
8169
8169
  * **Requirement set**: {@link https://learn.microsoft.com/javascript/api/requirement-sets/common/office-add-in-requirement-sets#settings | Settings}
8170
8170
  *
8171
8171
  * Any settings previously saved by an add-in are loaded when it is initialized, so during the lifetime of the session you can just use the
8172
- * set and get methods to work with the in-memory copy of the settings property bag. When you want to persist the settings so that they are
8173
- * available the next time the add-in is used, use the saveAsync method.
8172
+ * `set` and `get` methods to work with the in-memory copy of the settings property bag. When you want to persist the settings so that they are
8173
+ * available the next time the add-in is used, use the `saveAsync` method.
8174
8174
  *
8175
- * **Note**: The saveAsync method persists the in-memory settings property bag into the document file. However, the changes to the document file
8176
- * itself are saved only when the user (or AutoRecover setting) saves the document to the file system. The refreshAsync method is only useful
8175
+ * **Note**: The `saveAsync` method persists the in-memory settings property bag into the document file. However, the changes to the document file
8176
+ * itself are saved only when the user (or AutoRecover setting) saves the document to the file system. The `refreshAsync` method is only useful
8177
8177
  * in coauthoring scenarios when other instances of the same add-in might change the settings and those changes should be made available to
8178
8178
  * all instances.
8179
8179
  *
@@ -8192,11 +8192,11 @@ declare namespace Office {
8192
8192
  * </tr>
8193
8193
  * <tr>
8194
8194
  * <td><code>AsyncResult.error</code></td>
8195
- * <td>Access an Error object that provides error information if the operation failed.</td>
8195
+ * <td>Access an <code>Error</code> object that provides error information if the operation failed.</td>
8196
8196
  * </tr>
8197
8197
  * <tr>
8198
8198
  * <td><code>AsyncResult.asyncContext</code></td>
8199
- * <td>Define an item of any type that's returned in the AsyncResult object without being altered.</td>
8199
+ * <td>Define an item of any type that's returned in the <code>AsyncResult</code> object without being altered.</td>
8200
8200
  * </tr>
8201
8201
  * </table>
8202
8202
  *
@@ -8212,11 +8212,11 @@ declare namespace Office {
8212
8212
  * **Requirement set**: {@link https://learn.microsoft.com/javascript/api/requirement-sets/common/office-add-in-requirement-sets#settings | Settings}
8213
8213
  *
8214
8214
  * Any settings previously saved by an add-in are loaded when it is initialized, so during the lifetime of the session you can just use the
8215
- * set and get methods to work with the in-memory copy of the settings property bag. When you want to persist the settings so that they are
8216
- * available the next time the add-in is used, use the saveAsync method.
8215
+ * `set` and `get` methods to work with the in-memory copy of the settings property bag. When you want to persist the settings so that they are
8216
+ * available the next time the add-in is used, use the `saveAsync` method.
8217
8217
  *
8218
- * **Note**: The saveAsync method persists the in-memory settings property bag into the document file. However, the changes to the document file
8219
- * itself are saved only when the user (or AutoRecover setting) saves the document to the file system. The refreshAsync method is only useful
8218
+ * **Note**: The `saveAsync` method persists the in-memory settings property bag into the document file. However, the changes to the document file
8219
+ * itself are saved only when the user (or AutoRecover setting) saves the document to the file system. The `refreshAsync` method is only useful
8220
8220
  * in coauthoring scenarios when other instances of the same add-in might change the settings and those changes should be made available to
8221
8221
  * all instances.
8222
8222
  *
@@ -8235,11 +8235,11 @@ declare namespace Office {
8235
8235
  * </tr>
8236
8236
  * <tr>
8237
8237
  * <td><code>AsyncResult.error</code></td>
8238
- * <td>Access an Error object that provides error information if the operation failed.</td>
8238
+ * <td>Access an <code>Error</code> object that provides error information if the operation failed.</td>
8239
8239
  * </tr>
8240
8240
  * <tr>
8241
8241
  * <td><code>AsyncResult.asyncContext</code></td>
8242
- * <td>Define an item of any type that's returned in the AsyncResult object without being altered.</td>
8242
+ * <td>Define an item of any type that's returned in the <code>AsyncResult</code> object without being altered.</td>
8243
8243
  * </tr>
8244
8244
  * </table>
8245
8245
  *
@@ -8249,17 +8249,17 @@ declare namespace Office {
8249
8249
  /**
8250
8250
  * Sets or creates the specified setting.
8251
8251
  *
8252
- * **Important**: Be aware that the Settings.set method affects only the in-memory copy of the settings property bag.
8252
+ * **Important**: Be aware that the `Settings.set` method affects only the in-memory copy of the settings property bag.
8253
8253
  * To make sure that additions or changes to settings will be available to your add-in the next time the document is opened, at some point
8254
- * after calling the Settings.set method and before the add-in is closed, you must call the Settings.saveAsync method to persist settings in
8254
+ * after calling the `Settings.set` method and before the add-in is closed, you must call the `Settings.saveAsync` method to persist settings in
8255
8255
  * the document.
8256
8256
  *
8257
8257
  * @remarks
8258
8258
  *
8259
8259
  * **Requirement set**: {@link https://learn.microsoft.com/javascript/api/requirement-sets/common/office-add-in-requirement-sets#settings | Settings}
8260
8260
  *
8261
- * The set method creates a new setting of the specified name if it does not already exist, or sets an existing setting of the specified name
8262
- * in the in-memory copy of the settings property bag. After you call the Settings.saveAsync method, the value is stored in the document as
8261
+ * The `set` method creates a new setting of the specified name if it does not already exist, or sets an existing setting of the specified name
8262
+ * in the in-memory copy of the settings property bag. After you call the `Settings.saveAsync` method, the value is stored in the document as
8263
8263
  * the serialized JSON representation of its data type.
8264
8264
  *
8265
8265
  * @param settingName The case-sensitive name of the setting to set or create.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@types/office-js-preview",
3
- "version": "1.0.687",
3
+ "version": "1.0.688",
4
4
  "description": "TypeScript definitions for office-js-preview",
5
5
  "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/office-js-preview",
6
6
  "license": "MIT",
@@ -46,7 +46,7 @@
46
46
  "scripts": {},
47
47
  "dependencies": {},
48
48
  "peerDependencies": {},
49
- "typesPublisherContentHash": "c0dc5a735033bc99f54e4f115285b9c86a1f3b07e9391062503e1d98b4ad8d92",
49
+ "typesPublisherContentHash": "84e84345547544d85adf26a016e31aba743332b3c1ca822e36948e0d77009afe",
50
50
  "typeScriptVersion": "5.2",
51
51
  "nonNpm": true
52
52
  }