@types/office-js-preview 1.0.268 → 1.0.272

office-js-preview/index.d.ts

@@ -607,12 +607,12 @@ declare namespace Office {
          */
         hide(): Promise<void>;
         /**
-         * Adds a listener for the `onVisibilityModeChanged` event.
-         * @param listener - The listener function that is called when the event is emitted. This function takes in a message for the receiving component.
-         * @returns A promise that resolves to a function when the listener is added. Calling it removes the listener.
+         * Adds a handler for the `onVisibilityModeChanged` event.
+         * @param handler - The handler function that is called when the event is emitted. This function takes in a message for the receiving component.
+         * @returns A promise that resolves to a function when the handler is added. Calling it removes the handler.
          */
         onVisibilityModeChanged(
-            listener: (message: VisibilityModeChangedMessage) => void,
+            handler: (message: VisibilityModeChangedMessage) => void,
         ): Promise<() => Promise<void>>;
 
         /**
@@ -657,7 +657,7 @@ declare namespace Office {
          * This event handler will be triggered if one of the following conditions is met:
          * 1. When the notification dialog is open, the end user clicks the **Don't close** button within the dialog, clicks the Close button in the upper right corner of the dialog, or presses the Esc key.
          * 2. When the add-in calls the `enable` method on the `BeforeDocumentCloseNotification` object.
-         * @param listener The event handler that is called when the dialog is cancelled.
+         * @param handler The event handler that is called when the dialog is cancelled.
          * @returns A promise that resolves when the event handler is added.
          * 
          * @remarks
@@ -665,7 +665,7 @@ declare namespace Office {
          * @beta
         */
         onCloseActionCancelled(
-            listener: () => void
+            handler: () => void
         ): Promise<() => Promise<void>>;     
     }
     /**
@@ -1078,10 +1078,24 @@ declare namespace Office {
          *
          * @param eventType Specifies the type of event to add. This must be `Office.EventType.DialogParentMessageReceived`.
          * @param handler The event handler function to add, whose only parameter is of type {@link Office.DialogParentMessageReceivedEventArgs}.
-         * @param options Optional. Provides an option for preserving context data of any type, unchanged, for use in a callback.
+         * @param options Provides an option for preserving context data of any type, unchanged, for use in a callback.
          * @param callback Optional. A function that is invoked when the handler registration returns, whose only parameter is of type {@link Office.AsyncResult}.
          */
-        addHandlerAsync(eventType: Office.EventType, handler: (result: DialogParentMessageReceivedEventArgs) => void, options?: Office.AsyncContextOptions, callback?: (result: AsyncResult<void>) => void): void;
+        addHandlerAsync(eventType: Office.EventType, handler: (result: DialogParentMessageReceivedEventArgs) => void, options: Office.AsyncContextOptions, callback?: (result: AsyncResult<void>) => void): void;
+        /**
+          * Adds an event handler to the object using the specified event type.
+          *
+          * @remarks
+          *
+          * **Requirement set**: {@link https://docs.microsoft.com/office/dev/add-ins/reference/requirement-sets/dialog-api-requirement-sets | DialogApi 1.2}
+          *
+          * You can add multiple event handlers for the specified event type as long as the name of each event handler function is unique.
+          *
+          * @param eventType Specifies the type of event to add. This must be `Office.EventType.DialogParentMessageReceived`.
+          * @param handler The event handler function to add, whose only parameter is of type {@link Office.DialogParentMessageReceivedEventArgs}.
+          * @param callback Optional. A function that is invoked when the handler registration returns, whose only parameter is of type {@link Office.AsyncResult}.
+          */
+        addHandlerAsync(eventType: Office.EventType, handler: (result: DialogParentMessageReceivedEventArgs) => void, callback?: (result: AsyncResult<void>) => void): void;
         /**
         * Displays a dialog to show or collect information from the user or to facilitate Web navigation.
         *
@@ -9712,6 +9726,8 @@ declare namespace Office {
         /**
          * Manages the {@link Office.SessionData | SessionData} of an item in Compose mode.
          *
+         * **Important**: The entire SessionData object is limited to 50,000 characters per add-in.
+         *
          * @remarks
          * [Api set: Mailbox 1.11]
          *
@@ -14810,6 +14826,8 @@ declare namespace Office {
         /**
          * Manages the {@link Office.SessionData | SessionData} of an item in Compose mode.
          *
+         * **Important**: The entire SessionData object is limited to 50,000 characters per add-in.
+         *
          * @remarks
          * [Api set: Mailbox 1.11]
          *
@@ -18225,7 +18243,9 @@ declare namespace Office {
         setStartTime(time: string): void;
     }
     /**
-     * Provides methods to  manage an item's session data.
+     * Provides methods to manage an item's session data.
+     *
+     * **Important**: The entire SessionData object is limited to 50,000 characters per add-in.
      *
      * @remarks
      * [Api set: Mailbox 1.11]
@@ -18329,6 +18349,8 @@ declare namespace Office {
         /**
          * Sets a session data key-value pair.
          *
+         * **Important**: The entire SessionData object is limited to 50,000 characters per add-in.
+         *
          * @remarks
          * [Api set: Mailbox 1.11]
          *
@@ -18347,6 +18369,8 @@ declare namespace Office {
         /**
          * Sets a session data key-value pair.
          *
+         * **Important**: The entire SessionData object is limited to 50,000 characters per add-in.
+         *
          * @remarks
          * [Api set: Mailbox 1.11]
          *
@@ -19496,6 +19520,157 @@ declare namespace Excel {
         errorSubType?: CalcErrorCellValueSubType | "Unknown" | "ArrayOfArrays" | "ArrayOfRanges" | "EmptyArray" | "UnsupportedLifting" | "DataTableReferencedPendingFormula" | "TooManyCells" | "LambdaInCell";
     }
     /**
+    * Represents a reference to a property used by the card layout.
+    *
+    * @remarks
+    * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+    * @beta
+    */
+    interface CardLayoutPropertyReference {
+        /**
+        * The name of the property referenced by the card layout.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        property: string;
+    }
+    /**
+    * Properties of a card layout relevant to most card layouts.
+    *
+    * @remarks
+    * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+    * @beta
+    */
+    interface CardLayoutSectionStandardProperties {
+        /**
+        * Represents the title of this section of the card.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        title?: string;
+        /**
+        * Represents whether this section of the card is collapsible.
+        * If the card section has a title, the default value is `true`.
+        * If the card section doesn't have a title, the default value is `false`.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        collapsible?: boolean;
+        /**
+        * Represents whether this section of the card is initially collapsed.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        collapsed?: boolean;
+        /**
+        * Represents the names of the properties in this section.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        properties: string[];
+    }
+    /**
+    * Represents a section of a card that is arranged as a list in card view.
+    *
+    * @remarks
+    * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+    * @beta
+    */
+    interface CardLayoutListSection extends CardLayoutSectionStandardProperties {
+        /**
+        * Represents the type of layout for this section.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        layout: "List";
+    }
+    /**
+    * Represents a section of a card that is arranged as a table in card view.
+    *
+    * @remarks
+    * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+    * @beta
+    */
+    interface CardLayoutTableSection extends CardLayoutSectionStandardProperties {
+        /**
+        * Represents the type of layout for this section.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        layout: "Table";
+    }
+    /**
+    * Represents the layout of a section of a card in card view.
+    *
+    * @remarks
+    * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+    * @beta
+    */
+    type CardLayoutSection = CardLayoutListSection | CardLayoutTableSection;
+    /**
+    * Properties of a card layout relevant to most card layouts.
+    *
+    * @remarks
+    * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+    * @beta
+    */
+    interface CardLayoutStandardProperties {
+        /**
+        * Specifies a property which will be used as the main image of the card.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        mainImage?: CardLayoutPropertyReference;
+        /**
+        * Represents the title of the card or the specification of which property contains the title of the card.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        title?: string | CardLayoutPropertyReference;
+        /**
+        * Represents a specification of which property contains the subtitle of the card.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        subTitle?: CardLayoutPropertyReference;
+        /**
+        * Represents the sections of the card.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        sections?: CardLayoutSection[];
+    }
+    /**
+    * Represents the layout of a card in card view.
+    *
+    * @remarks
+    * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+    * @beta
+    */
+    type CardLayout = EntityCardLayout;
+    /**
     * Represents the types of the `CellValue` object.
     *
     * @remarks
@@ -19591,7 +19766,7 @@ declare namespace Excel {
     * [Api set: ExcelApi BETA (PREVIEW ONLY)]
     * @beta
     */
-    type CellValue = ArrayCellValue | BooleanCellValue | DoubleCellValue | EntityCellValue | EmptyCellValue | ErrorCellValue | FormattedNumberCellValue | StringCellValue | ValueTypeNotAvailableCellValue | WebImageCellValue & {
+    type CellValue = ArrayCellValue | BooleanCellValue | DoubleCellValue | EntityCellValue | EmptyCellValue | ErrorCellValue | FormattedNumberCellValue | StringCellValue | ValueTypeNotAvailableCellValue | WebImageCellValue | string | number | boolean & {
         /**
         * Represents whether this `CellValue` will be used to overwrite a cell.
         * When false, APIs which would use this `CellValue` to overwrite a cell will instead ignore this value without throwing an error.
@@ -19613,6 +19788,23 @@ declare namespace Excel {
         writableNote?: string;
     };
     /**
+    * Represents the value and metadata of a property. The metadata applies to the property (and not the value), but it is combined with the value in this type.
+    *
+    * @remarks
+    * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+    * @beta
+    */
+    type CellValueAndPropertyMetadata = CellValue & {
+        /**
+        * Represents metadata about the property.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        propertyMetadata?: CellValuePropertyMetadata;
+    };
+    /**
     * The attribution attributes object represents the set of details that can be used to describe where information came from, if the information comes from a public source.
     *
     * @remarks
@@ -20063,6 +20255,14 @@ declare namespace Excel {
         basicType?: RangeValueType.empty | "Empty";
     }
     /**
+    * Represents the value of a property.
+    *
+    * @remarks
+    * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+    * @beta
+    */
+    type EntityPropertyType = CellValueAndPropertyMetadata | CellValue;
+    /**
     * Represents an schemaless set of properties.
     *
     * @remarks
@@ -20110,10 +20310,34 @@ declare namespace Excel {
         * @beta
         */
         properties?: {
-            [key: string]: CellValue & {
-                propertyMetadata?: CellValuePropertyMetadata;
-            };
+            [key: string]: EntityPropertyType;
         };
+        /**
+        * Represents the layout of this entity in card view.
+        * If the `CardLayout` object does not have a layout property, it is assumed to be "Entity".
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        cardLayout?: CardLayout;
+    }
+    /**
+    * Represents a card layout best used for an entity.
+    *
+    * @remarks
+    * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+    * @beta
+    */
+    interface EntityCardLayout extends CardLayoutStandardProperties {
+        /**
+        * Represent the type of this layout.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        layout?: "Entity";
     }
     /**
     * Represents the types of the `ErrorCellValue` object.
@@ -22086,7 +22310,7 @@ declare namespace Excel {
          * @beta
          *
          * @param key The title of the `AllowEditRange`.
-         * @returns The `AllowEditRange` with the title. If there is no `AllowEditRange` with the given title, then this function will return an object with its `isNullObject` property set to `true`. For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
+         * @returns The `AllowEditRange` with the title. If there is no `AllowEditRange` with the given title, then this method returns an object with its `isNullObject` property set to `true`. For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          */
         getItemOrNullObject(key: string): Excel.AllowEditRange;
         /**
@@ -22584,7 +22808,7 @@ declare namespace Excel {
          */
         getItem(key: string): Excel.LinkedWorkbook;
         /**
-         * Gets information about a linked workbook by its URL. If the workbook does not exist, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets information about a linked workbook by its URL. If the workbook does not exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties  | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -23334,7 +23558,7 @@ declare namespace Excel {
          * @beta
          *
          * @param key The ID of the task.
-         * @returns The task with the given ID. If there is no task with the given ID, then this function will return an object with its `isNullObject` property set to `true`.
+         * @returns The task with the given ID. If there is no task with the given ID, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          */
         getItemOrNullObject(key: string): Excel.DocumentTask;
@@ -27167,7 +27391,7 @@ declare namespace Excel {
          */
         getActiveChart(): Excel.Chart;
         /**
-         * Gets the currently active chart in the workbook. If there is no active chart, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets the currently active chart in the workbook. If there is no active chart, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -27182,7 +27406,7 @@ declare namespace Excel {
          */
         getActiveSlicer(): Excel.Slicer;
         /**
-         * Gets the currently active slicer in the workbook. If there is no active slicer, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets the currently active slicer in the workbook. If there is no active slicer, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -27663,7 +27887,7 @@ declare namespace Excel {
          *
          * @param text The string to find.
          * @param criteria Additional search criteria, including whether the search needs to match the entire cell or be case-sensitive.
-         * @returns A `RangeAreas` object, comprising one or more rectangular ranges, that matches the search criteria. If there are no matches, then this function will return an object with its `isNullObject` property set to `true`.
+         * @returns A `RangeAreas` object, comprising one or more rectangular ranges, that matches the search criteria. If there are no matches, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          */
         findAllOrNullObject(text: string, criteria: Excel.WorksheetSearchCriteria): Excel.RangeAreas;
@@ -27687,7 +27911,7 @@ declare namespace Excel {
          */
         getNext(visibleOnly?: boolean): Excel.Worksheet;
         /**
-         * Gets the worksheet that follows this one. If there are no worksheets following this one, then this method will return an object with its `isNullObject` property set to `true`.
+         * Gets the worksheet that follows this one. If there are no worksheets following this one, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -27706,7 +27930,7 @@ declare namespace Excel {
          */
         getPrevious(visibleOnly?: boolean): Excel.Worksheet;
         /**
-         * Gets the worksheet that precedes this one. If there are no previous worksheets, then this method will return an object with its `isNullObject` property set to `true`.
+         * Gets the worksheet that precedes this one. If there are no previous worksheets, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -27755,7 +27979,7 @@ declare namespace Excel {
          */
         getUsedRange(valuesOnly?: boolean): Excel.Range;
         /**
-         * The used range is the smallest range that encompasses any cells that have a value or formatting assigned to them. If the entire worksheet is blank, then this function will return an object with its `isNullObject` property set to `true`. For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
+         * The used range is the smallest range that encompasses any cells that have a value or formatting assigned to them. If the entire worksheet is blank, then this method returns an object with its `isNullObject` property set to `true`. For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
          * [Api set: ExcelApi 1.4]
@@ -28043,7 +28267,7 @@ declare namespace Excel {
          */
         getItem(key: string): Excel.Worksheet;
         /**
-         * Gets a worksheet object using its name or ID. If the worksheet does not exist, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets a worksheet object using its name or ID. If the worksheet does not exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -28562,7 +28786,7 @@ declare namespace Excel {
         /**
          * Gets a range that describes the frozen cells in the active worksheet view.
                     The frozen range corresponds to cells that are frozen in the top- and left-most pane.
-                    If there is no frozen pane, then this function will return an object with its `isNullObject` property set to `true`.
+                    If there is no frozen pane, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -28870,6 +29094,15 @@ declare namespace Excel {
          * [Api set: ExcelApi 1.1]
          */
         values: any[][];
+        /**
+         * A JSON representation of the values in the cells in this range.
+                    Unlike `Range.values`, `Range.valuesAsJson` supports all data types which can be in a cell.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        valuesAsJson: CellValue[][];
         /**
          * Returns the distance in points, for 100% zoom, from the left edge of the range to the right edge of the range.
          *
@@ -29014,7 +29247,7 @@ declare namespace Excel {
         /**
          * Finds the given string based on the criteria specified.
                     If the current range is larger than a single cell, then the search will be limited to that range, else the search will cover the entire sheet starting after that cell.
-                    If there are no matches, then this function will return an object with its `isNullObject` property set to `true`.
+                    If there are no matches, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -29182,7 +29415,7 @@ declare namespace Excel {
          */
         getIntersection(anotherRange: Range | string): Excel.Range;
         /**
-         * Gets the range object that represents the rectangular intersection of the given ranges. If no intersection is found, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets the range object that represents the rectangular intersection of the given ranges. If no intersection is found, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -29337,7 +29570,7 @@ declare namespace Excel {
         getSpecialCells(cellType: "ConditionalFormats" | "DataValidations" | "Blanks" | "Constants" | "Formulas" | "SameConditionalFormat" | "SameDataValidation" | "Visible", cellValueType?: "All" | "Errors" | "ErrorsLogical" | "ErrorsNumbers" | "ErrorsText" | "ErrorsLogicalNumber" | "ErrorsLogicalText" | "ErrorsNumberText" | "Logical" | "LogicalNumbers" | "LogicalText" | "LogicalNumbersText" | "Numbers" | "NumbersText" | "Text"): Excel.RangeAreas;
         /**
          * Gets the `RangeAreas` object, comprising one or more ranges, that represents all the cells that match the specified type and value.
-                    If no special cells are found, then this function will return an object with its `isNullObject` property set to `true`.
+                    If no special cells are found, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -29349,7 +29582,7 @@ declare namespace Excel {
         getSpecialCellsOrNullObject(cellType: Excel.SpecialCellType, cellValueType?: Excel.SpecialCellValueType): Excel.RangeAreas;
         /**
          * Gets the `RangeAreas` object, comprising one or more ranges, that represents all the cells that match the specified type and value.
-                    If no special cells are found, then this function will return an object with its `isNullObject` property set to `true`.
+                    If no special cells are found, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -29368,7 +29601,7 @@ declare namespace Excel {
         getSpillParent(): Excel.Range;
         /**
          * Gets the range object containing the anchor cell for the cell getting spilled into.
-                    If it's not a spilled cell, or more than one cell is given, then this function will return an object with its `isNullObject` property set to `true`.
+                    If it's not a spilled cell, or more than one cell is given, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -29384,7 +29617,7 @@ declare namespace Excel {
         getSpillingToRange(): Excel.Range;
         /**
          * Gets the range object containing the spill range when called on an anchor cell.
-                    If the range isn't an anchor cell or the spill range can't be found, then this function will return an object with its `isNullObject` property set to `true`.
+                    If the range isn't an anchor cell or the spill range can't be found, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -29417,7 +29650,7 @@ declare namespace Excel {
          */
         getUsedRange(valuesOnly?: boolean): Excel.Range;
         /**
-         * Returns the used range of the given range object. If there are no used cells within the range, then this function will return an object with its `isNullObject` property set to `true`.
+         * Returns the used range of the given range object. If there are no used cells within the range, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -29908,7 +30141,7 @@ declare namespace Excel {
          */
         getIntersection(anotherRange: Range | RangeAreas | string): Excel.RangeAreas;
         /**
-         * Returns the `RangeAreas` object that represents the intersection of the given ranges or `RangeAreas`. If no intersection is found, then this function will return an object with its `isNullObject` property set to `true`.
+         * Returns the `RangeAreas` object that represents the intersection of the given ranges or `RangeAreas`. If no intersection is found, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -29948,7 +30181,7 @@ declare namespace Excel {
          */
         getSpecialCells(cellType: "ConditionalFormats" | "DataValidations" | "Blanks" | "Constants" | "Formulas" | "SameConditionalFormat" | "SameDataValidation" | "Visible", cellValueType?: "All" | "Errors" | "ErrorsLogical" | "ErrorsNumbers" | "ErrorsText" | "ErrorsLogicalNumber" | "ErrorsLogicalText" | "ErrorsNumberText" | "Logical" | "LogicalNumbers" | "LogicalText" | "LogicalNumbersText" | "Numbers" | "NumbersText" | "Text"): Excel.RangeAreas;
         /**
-         * Returns a `RangeAreas` object that represents all the cells that match the specified type and value. If no special cells are found that match the criteria, then this function will return an object with its `isNullObject` property set to `true`.
+         * Returns a `RangeAreas` object that represents all the cells that match the specified type and value. If no special cells are found that match the criteria, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -29959,7 +30192,7 @@ declare namespace Excel {
          */
         getSpecialCellsOrNullObject(cellType: Excel.SpecialCellType, cellValueType?: Excel.SpecialCellValueType): Excel.RangeAreas;
         /**
-         * Returns a `RangeAreas` object that represents all the cells that match the specified type and value. If no special cells are found that match the criteria, then this function will return an object with its `isNullObject` property set to `true`.
+         * Returns a `RangeAreas` object that represents all the cells that match the specified type and value. If no special cells are found that match the criteria, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -29990,7 +30223,7 @@ declare namespace Excel {
         getUsedRangeAreas(valuesOnly?: boolean): Excel.RangeAreas;
         /**
          * Returns the used `RangeAreas` that comprises all the used areas of individual rectangular ranges in the `RangeAreas` object.
-                    If there are no used cells within the `RangeAreas`, then this function will return an object with its `isNullObject` property set to `true`.
+                    If there are no used cells within the `RangeAreas`, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -30081,7 +30314,7 @@ declare namespace Excel {
          */
         getRangeAreasBySheet(key: string): Excel.RangeAreas;
         /**
-         * Returns the `RangeAreas` object based on worksheet name or ID in the collection. If the worksheet does not exist, then this function will return an object with its `isNullObject` property set to `true`.
+         * Returns the `RangeAreas` object based on worksheet name or ID in the collection. If the worksheet does not exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -30697,6 +30930,15 @@ declare namespace Excel {
          * [Api set: ExcelApi 1.3]
          */
         values: any[][];
+        /**
+         * A JSON representation of the values in the cells in this range.
+                    Unlike `RangeView.values`, `RangeView.valuesAsJson` supports all data types which can be in a cell.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        valuesAsJson: CellValue[][];
         /**
          * Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate properties, or another API object of the same type.
          * @param properties A JavaScript object with properties that are structured isomorphically to the properties of the object on which the method is called.
@@ -30828,7 +31070,7 @@ declare namespace Excel {
          */
         getItem(key: string): Excel.Setting;
         /**
-         * Gets a setting entry via the key. If the setting does not exist, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets a setting entry via the key. If the setting does not exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -30987,7 +31229,7 @@ declare namespace Excel {
          */
         getItem(name: string): Excel.NamedItem;
         /**
-         * Gets a `NamedItem` object using its name. If the object does not exist, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets a `NamedItem` object using its name. If the object does not exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -31044,7 +31286,7 @@ declare namespace Excel {
          */
         readonly worksheet: Excel.Worksheet;
         /**
-         * Returns the worksheet to which the named item is scoped. If the item is scoped to the workbook instead, then this function will return an object with its `isNullObject` property set to `true`.
+         * Returns the worksheet to which the named item is scoped. If the item is scoped to the workbook instead, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -31093,6 +31335,15 @@ declare namespace Excel {
          * [Api set: ExcelApi 1.1]
          */
         readonly value: any;
+        /**
+         * A JSON representation of the values in this named item.
+                    Unlike `NamedItem.value`, `NamedItem.valueAsJson` supports all data types which can be in a cell.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        readonly valueAsJson: CellValue;
         /**
          * Specifies if the object is visible.
          *
@@ -31123,7 +31374,7 @@ declare namespace Excel {
          */
         getRange(): Excel.Range;
         /**
-         * Returns the range object that is associated with the name. If the named item's type is not a range, then this function will return an object with its `isNullObject` property set to `true`.
+         * Returns the range object that is associated with the name. If the named item's type is not a range, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -31180,6 +31431,15 @@ declare namespace Excel {
          * [Api set: ExcelApi 1.7]
          */
         readonly values: any[][];
+        /**
+         * A JSON representation of the values in the cells in this range.
+                    Unlike `NamedItemArrayValues.values`, `NamedItemArrayValues.valuesAsJson` supports all data types which can be in a cell.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        readonly valuesAsJson: CellValue[][];
         /**
          * Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading the properties.
          *
@@ -31417,7 +31677,7 @@ declare namespace Excel {
          */
         getItemAt(index: number): Excel.Binding;
         /**
-         * Gets a binding object by ID. If the binding object does not exist, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets a binding object by ID. If the binding object does not exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -31504,7 +31764,7 @@ declare namespace Excel {
          */
         getItemAt(index: number): Excel.Table;
         /**
-         * Gets a table by name or ID. If the table doesn't exist, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets a table by name or ID. If the table doesn't exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -31610,7 +31870,7 @@ declare namespace Excel {
         getItem(key: string): Excel.Table;
         /**
          * Gets a table by name or ID.
-                    If the table object does not exist, then this function will return an object with its `isNullObject` property set to `true`.
+                    If the table object does not exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties  | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -31976,7 +32236,7 @@ declare namespace Excel {
          */
         getItemAt(index: number): Excel.TableColumn;
         /**
-         * Gets a column object by name or ID. If the column doesn't exist, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets a column object by name or ID. If the column doesn't exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -32054,6 +32314,15 @@ declare namespace Excel {
          * [Api set: ExcelApi 1.1]
          */
         values: any[][];
+        /**
+         * A JSON representation of the values in the cells in this table column.
+                    Unlike `TableColumn.values`, `TableColumn.valuesAsJson` supports all data types which can be in a cell.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        valuesAsJson: CellValue[][];
         /**
          * Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate properties, or another API object of the same type.
          * @param properties A JavaScript object with properties that are structured isomorphically to the properties of the object on which the method is called.
@@ -32258,6 +32527,15 @@ declare namespace Excel {
          * [Api set: ExcelApi 1.1]
          */
         values: any[][];
+        /**
+         * A JSON representation of the values in the cells in this table row.
+                    Unlike `TableRow.values`, `TableRow.valuesAsJson` supports all data types which can be in a cell.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        valuesAsJson: CellValue[][];
         /**
          * Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate properties, or another API object of the same type.
          * @param properties A JavaScript object with properties that are structured isomorphically to the properties of the object on which the method is called.
@@ -33376,7 +33654,7 @@ declare namespace Excel {
          */
         getItemAt(index: number): Excel.Chart;
         /**
-         * Gets a chart using its name. If there are multiple charts with the same name, the first one will be returned. If the chart doesn't exist, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets a chart using its name. If there are multiple charts with the same name, the first one will be returned. If the chart doesn't exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -33655,7 +33933,7 @@ declare namespace Excel {
          */
         getDataTable(): Excel.ChartDataTable;
         /**
-         * Gets the data table on the chart. If the chart doesn't allow a data table, then this function returns an object with its `isNullObject` property set to `true`.
+         * Gets the data table on the chart. If the chart doesn't allow a data table, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -38629,7 +38907,7 @@ declare namespace Excel {
         getItem(id: string): Excel.CustomXmlPart;
         /**
          * Gets a custom XML part based on its ID.
-                    If the `CustomXmlPart` does not exist, then this function returns an object with its `isNullObject` property set to `true`.
+                    If the `CustomXmlPart` does not exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -38725,7 +39003,7 @@ declare namespace Excel {
         getItem(id: string): Excel.CustomXmlPart;
         /**
          * Gets a custom XML part based on its ID.
-                    If the `CustomXmlPart` does not exist, then this function returns an object with its `isNullObject` property set to `true`.
+                    If the `CustomXmlPart` does not exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -38858,7 +39136,7 @@ declare namespace Excel {
         getFirst(): Excel.PivotTable;
         /**
          * Gets the first PivotTable in the collection. The PivotTables in the collection are sorted top-to-bottom and left-to-right, such that the top-left table is the first PivotTable in the collection.
-                    If the collection is empty, then this function returns an object with its `isNullObject` property set to `true`.
+                    If the collection is empty, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -38876,7 +39154,7 @@ declare namespace Excel {
          */
         getItem(key: string): Excel.PivotTable;
         /**
-         * Gets a PivotTable by name. If the PivotTable does not exist, then this function returns an object with its `isNullObject` property set to `true`.
+         * Gets a PivotTable by name. If the PivotTable does not exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -38949,7 +39227,7 @@ declare namespace Excel {
          */
         getItem(name: string): Excel.PivotTable;
         /**
-         * Gets a PivotTable by name. If the PivotTable does not exist, then this function returns an object with its `isNullObject` property set to `true`.
+         * Gets a PivotTable by name. If the PivotTable does not exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -39508,7 +39786,7 @@ declare namespace Excel {
          */
         getItem(name: string): Excel.PivotHierarchy;
         /**
-         * Gets a PivotHierarchy by name. If the PivotHierarchy does not exist, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets a PivotHierarchy by name. If the PivotHierarchy does not exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -39642,7 +39920,7 @@ declare namespace Excel {
          */
         getItem(name: string): Excel.RowColumnPivotHierarchy;
         /**
-         * Gets a RowColumnPivotHierarchy by name. If the RowColumnPivotHierarchy does not exist, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets a RowColumnPivotHierarchy by name. If the RowColumnPivotHierarchy does not exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -39797,7 +40075,7 @@ declare namespace Excel {
          */
         getItem(name: string): Excel.FilterPivotHierarchy;
         /**
-         * Gets a FilterPivotHierarchy by name. If the FilterPivotHierarchy does not exist, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets a FilterPivotHierarchy by name. If the FilterPivotHierarchy does not exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -39958,7 +40236,7 @@ declare namespace Excel {
          */
         getItem(name: string): Excel.DataPivotHierarchy;
         /**
-         * Gets a DataPivotHierarchy by name. If the DataPivotHierarchy does not exist, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets a DataPivotHierarchy by name. If the DataPivotHierarchy does not exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -40153,7 +40431,7 @@ declare namespace Excel {
          */
         getItem(name: string): Excel.PivotField;
         /**
-         * Gets a PivotField by name. If the PivotField does not exist, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets a PivotField by name. If the PivotField does not exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -40395,7 +40673,7 @@ declare namespace Excel {
          */
         getItem(name: string): Excel.PivotItem;
         /**
-         * Gets a PivotItem by name. If the PivotItem does not exist, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets a PivotItem by name. If the PivotItem does not exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -40921,7 +41199,7 @@ declare namespace Excel {
          */
         getItem(key: string): Excel.WorksheetCustomProperty;
         /**
-         * Gets a custom property object by its key, which is case-insensitive. If the custom property doesn't exist, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets a custom property object by its key, which is case-insensitive. If the custom property doesn't exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -40964,7 +41242,7 @@ declare namespace Excel {
         /** The request context associated with the object. This connects the add-in's process to the Office host application's process. */
         context: RequestContext;
         /**
-         * Gets the collection of custom properties of the workbook. Read only.
+         * Gets the collection of custom properties of the workbook.
          *
          * @remarks
          * [Api set: ExcelApi 1.7]
@@ -40999,7 +41277,7 @@ declare namespace Excel {
          */
         company: string;
         /**
-         * Gets the creation date of the workbook. Read only.
+         * Gets the creation date of the workbook.
          *
          * @remarks
          * [Api set: ExcelApi 1.7]
@@ -41013,7 +41291,7 @@ declare namespace Excel {
          */
         keywords: string;
         /**
-         * Gets the last author of the workbook. Read only.
+         * Gets the last author of the workbook.
          *
          * @remarks
          * [Api set: ExcelApi 1.7]
@@ -41027,7 +41305,7 @@ declare namespace Excel {
          */
         manager: string;
         /**
-         * Gets the revision number of the workbook. Read only.
+         * Gets the revision number of the workbook.
          *
          * @remarks
          * [Api set: ExcelApi 1.7]
@@ -41199,7 +41477,7 @@ declare namespace Excel {
          */
         getItem(key: string): Excel.CustomProperty;
         /**
-         * Gets a custom property object by its key, which is case-insensitive. If the custom property doesn't exist, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets a custom property object by its key, which is case-insensitive. If the custom property doesn't exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -41296,7 +41574,7 @@ declare namespace Excel {
         getItemAt(index: number): Excel.ConditionalFormat;
         /**
          * Returns a conditional format identified by its ID.
-                    If the conditional format object does not exist, then this function will return an object with its `isNullObject` property set to `true`.
+                    If the conditional format object does not exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties  | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -41511,7 +41789,7 @@ declare namespace Excel {
          */
         getRange(): Excel.Range;
         /**
-         * Returns the range to which the conditonal format is applied. If the conditional format is applied to multiple ranges, then this function will return an object with its `isNullObject` property set to `true`.
+         * Returns the range to which the conditonal format is applied. If the conditional format is applied to multiple ranges, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -43120,7 +43398,7 @@ declare namespace Excel {
         getItemAt(index: number): Excel.Style;
         /**
          * Gets a style by name.
-                    If the style object does not exist, then this function will return an object with its `isNullObject` property set to `true`.
+                    If the style object does not exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties  | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -43201,7 +43479,7 @@ declare namespace Excel {
          */
         getItem(name: string): Excel.TableStyle;
         /**
-         * Gets a `TableStyle` by name. If the table style does not exist, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets a `TableStyle` by name. If the table style does not exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -43365,7 +43643,7 @@ declare namespace Excel {
          */
         getItem(name: string): Excel.PivotTableStyle;
         /**
-         * Gets a `PivotTableStyle` by name. If the `PivotTableStyle` does not exist, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets a `PivotTableStyle` by name. If the `PivotTableStyle` does not exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -43529,7 +43807,7 @@ declare namespace Excel {
          */
         getItem(name: string): Excel.SlicerStyle;
         /**
-         * Gets a `SlicerStyle` by name. If the slicer style doesn't exist, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets a `SlicerStyle` by name. If the slicer style doesn't exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -43693,7 +43971,7 @@ declare namespace Excel {
          */
         getItem(name: string): Excel.TimelineStyle;
         /**
-         * Gets a `TimelineStyle` by name. If the timeline style doesn't exist, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets a `TimelineStyle` by name. If the timeline style doesn't exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -43975,7 +44253,7 @@ declare namespace Excel {
          */
         getPrintArea(): Excel.RangeAreas;
         /**
-         * Gets the `RangeAreas` object, comprising one or more rectangular ranges, that represents the print area for the worksheet. If there is no print area, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets the `RangeAreas` object, comprising one or more rectangular ranges, that represents the print area for the worksheet. If there is no print area, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -43990,7 +44268,7 @@ declare namespace Excel {
          */
         getPrintTitleColumns(): Excel.Range;
         /**
-         * Gets the range object representing the title columns. If not set, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets the range object representing the title columns. If not set, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -44005,7 +44283,7 @@ declare namespace Excel {
          */
         getPrintTitleRows(): Excel.Range;
         /**
-         * Gets the range object representing the title rows. If not set, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets the range object representing the title rows. If not set, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -44726,7 +45004,7 @@ declare namespace Excel {
         getItemByReplyId(replyId: string): Excel.Comment;
         /**
          * Gets a comment from the collection based on its ID.
-                    If the comment object does not exist, then this function will return an object with its `isNullObject` property set to `true`.
+                    If the comment object does not exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties  | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -44906,7 +45184,7 @@ declare namespace Excel {
          */
         getTask(): Excel.DocumentTask;
         /**
-         * Gets the task associated with this comment. If there is no task for the comment thread, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets the task associated with this comment. If there is no task for the comment thread, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -45008,7 +45286,7 @@ declare namespace Excel {
         getItemAt(index: number): Excel.CommentReply;
         /**
          * Returns a comment reply identified by its ID.
-                    If the comment reply object does not exist, then this function will return an object with its `isNullObject` property set to `true`.
+                    If the comment reply object does not exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties  | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -45161,7 +45439,7 @@ declare namespace Excel {
          */
         getTask(): Excel.DocumentTask;
         /**
-         * Gets the task associated with this comment reply's thread. If there is no task for the comment thread, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets the task associated with this comment reply's thread. If there is no task for the comment thread, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -45324,7 +45602,7 @@ declare namespace Excel {
         getItemAt(index: number): Excel.Shape;
         /**
          * Gets a shape using its name or ID.
-                    If the shape object does not exist, then this function will return an object with its `isNullObject` property set to `true`.
+                    If the shape object does not exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties  | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -45417,7 +45695,7 @@ declare namespace Excel {
          */
         readonly parentGroup: Excel.Shape;
         /**
-         * Returns the text frame object of this shape. Read only.
+         * Returns the text frame object of this shape.
          *
          * @remarks
          * [Api set: ExcelApi 1.9]
@@ -45943,7 +46221,7 @@ declare namespace Excel {
         getItemAt(index: number): Excel.Shape;
         /**
          * Gets a shape using its name or ID.
-                    If the shape object does not exist, then this function will return an object with its `isNullObject` property set to `true`.
+                    If the shape object does not exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties  | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -46860,7 +47138,7 @@ declare namespace Excel {
          */
         getItemAt(index: number): Excel.Slicer;
         /**
-         * Gets a slicer using its name or ID. If the slicer doesn't exist, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets a slicer using its name or ID. If the slicer doesn't exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -47004,7 +47282,7 @@ declare namespace Excel {
          */
         getItemAt(index: number): Excel.SlicerItem;
         /**
-         * Gets a slicer item using its key or name. If the slicer item doesn't exist, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets a slicer item using its key or name. If the slicer item doesn't exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -47206,7 +47484,7 @@ declare namespace Excel {
          */
         getItemAt(index: number): Excel.LinkedDataType;
         /**
-         * Gets a linked data type by ID. If the linked data type doesn't exist, then this function will return an object with its `isNullObject` property set to `true`.
+         * Gets a linked data type by ID. If the linked data type doesn't exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -54450,7 +54728,7 @@ declare namespace Excel {
         getItemAt(index: number): Excel.NamedSheetView;
         /**
          * Gets a sheet view using its name.
-                    If the sheet view object does not exist, then this function will return an object with its `isNullObject` property set to `true`.
+                    If the sheet view object does not exist, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties  | *OrNullObject methods and properties}.
          *
          * @remarks
@@ -58310,6 +58588,7 @@ declare namespace Excel {
         nonBlankCellOffSheet = "NonBlankCellOffSheet",
         notImplemented = "NotImplemented",
         openWorkbookLinksBlocked = "OpenWorkbookLinksBlocked",
+        operationCellsExceedLimit = "OperationCellsExceedLimit",
         pivotTableRangeConflict = "PivotTableRangeConflict",
         rangeExceedsLimit = "RangeExceedsLimit",
         refreshWorkbookLinksBlocked = "RefreshWorkbookLinksBlocked",
@@ -58822,6 +59101,15 @@ declare namespace Excel {
              * [Api set: ExcelApi 1.1]
              */
             values?: any[][];
+            /**
+             * A JSON representation of the values in the cells in this range.
+                        Unlike `Range.values`, `Range.valuesAsJson` supports all data types which can be in a cell.
+             *
+             * @remarks
+             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+             * @beta
+             */
+            valuesAsJson?: CellValue[][];
         }
         /** An interface for updating data on the RangeAreas object, for use in `rangeAreas.set({ ... })`. */
         interface RangeAreasUpdateData {
@@ -58886,6 +59174,15 @@ declare namespace Excel {
              * [Api set: ExcelApi 1.3]
              */
             values?: any[][];
+            /**
+             * A JSON representation of the values in the cells in this range.
+                        Unlike `RangeView.values`, `RangeView.valuesAsJson` supports all data types which can be in a cell.
+             *
+             * @remarks
+             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+             * @beta
+             */
+            valuesAsJson?: CellValue[][];
         }
         /** An interface for updating data on the RangeViewCollection object, for use in `rangeViewCollection.set({ ... })`. */
         interface RangeViewCollectionUpdateData {
@@ -59042,6 +59339,15 @@ declare namespace Excel {
              * [Api set: ExcelApi 1.1]
              */
             values?: any[][];
+            /**
+             * A JSON representation of the values in the cells in this table column.
+                        Unlike `TableColumn.values`, `TableColumn.valuesAsJson` supports all data types which can be in a cell.
+             *
+             * @remarks
+             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+             * @beta
+             */
+            valuesAsJson?: CellValue[][];
         }
         /** An interface for updating data on the TableRowCollection object, for use in `tableRowCollection.set({ ... })`. */
         interface TableRowCollectionUpdateData {
@@ -59057,6 +59363,15 @@ declare namespace Excel {
              * [Api set: ExcelApi 1.1]
              */
             values?: any[][];
+            /**
+             * A JSON representation of the values in the cells in this table row.
+                        Unlike `TableRow.values`, `TableRow.valuesAsJson` supports all data types which can be in a cell.
+             *
+             * @remarks
+             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+             * @beta
+             */
+            valuesAsJson?: CellValue[][];
         }
         /** An interface for updating data on the DataValidation object, for use in `dataValidation.set({ ... })`. */
         interface DataValidationUpdateData {
@@ -61792,7 +62107,7 @@ declare namespace Excel {
              */
             manager?: string;
             /**
-             * Gets the revision number of the workbook. Read only.
+             * Gets the revision number of the workbook.
              *
              * @remarks
              * [Api set: ExcelApi 1.7]
@@ -64444,6 +64759,15 @@ declare namespace Excel {
              * [Api set: ExcelApi 1.1]
              */
             values?: any[][];
+            /**
+             * A JSON representation of the values in the cells in this range.
+                        Unlike `Range.values`, `Range.valuesAsJson` supports all data types which can be in a cell.
+             *
+             * @remarks
+             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+             * @beta
+             */
+            valuesAsJson?: CellValue[][];
             /**
              * Returns the distance in points, for 100% zoom, from the left edge of the range to the right edge of the range.
              *
@@ -64644,6 +64968,15 @@ declare namespace Excel {
              * [Api set: ExcelApi 1.3]
              */
             values?: any[][];
+            /**
+             * A JSON representation of the values in the cells in this range.
+                        Unlike `RangeView.values`, `RangeView.valuesAsJson` supports all data types which can be in a cell.
+             *
+             * @remarks
+             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+             * @beta
+             */
+            valuesAsJson?: CellValue[][];
         }
         /** An interface describing the data returned by calling `rangeViewCollection.toJSON()`. */
         interface RangeViewCollectionData {
@@ -64725,6 +65058,15 @@ declare namespace Excel {
              * [Api set: ExcelApi 1.1]
              */
             value?: any;
+            /**
+             * A JSON representation of the values in this named item.
+                        Unlike `NamedItem.value`, `NamedItem.valueAsJson` supports all data types which can be in a cell.
+             *
+             * @remarks
+             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+             * @beta
+             */
+            valueAsJson?: CellValue;
             /**
              * Specifies if the object is visible.
              *
@@ -64749,6 +65091,15 @@ declare namespace Excel {
              * [Api set: ExcelApi 1.7]
              */
             values?: any[][];
+            /**
+             * A JSON representation of the values in the cells in this range.
+                        Unlike `NamedItemArrayValues.values`, `NamedItemArrayValues.valuesAsJson` supports all data types which can be in a cell.
+             *
+             * @remarks
+             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+             * @beta
+             */
+            valuesAsJson?: CellValue[][];
         }
         /** An interface describing the data returned by calling `binding.toJSON()`. */
         interface BindingData {
@@ -64939,6 +65290,15 @@ declare namespace Excel {
              * [Api set: ExcelApi 1.1]
              */
             values?: any[][];
+            /**
+             * A JSON representation of the values in the cells in this table column.
+                        Unlike `TableColumn.values`, `TableColumn.valuesAsJson` supports all data types which can be in a cell.
+             *
+             * @remarks
+             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+             * @beta
+             */
+            valuesAsJson?: CellValue[][];
         }
         /** An interface describing the data returned by calling `tableRowCollection.toJSON()`. */
         interface TableRowCollectionData {
@@ -64961,6 +65321,15 @@ declare namespace Excel {
              * [Api set: ExcelApi 1.1]
              */
             values?: any[][];
+            /**
+             * A JSON representation of the values in the cells in this table row.
+                        Unlike `TableRow.values`, `TableRow.valuesAsJson` supports all data types which can be in a cell.
+             *
+             * @remarks
+             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+             * @beta
+             */
+            valuesAsJson?: CellValue[][];
         }
         /** An interface describing the data returned by calling `dataValidation.toJSON()`. */
         interface DataValidationData {
@@ -68134,7 +68503,7 @@ declare namespace Excel {
         /** An interface describing the data returned by calling `documentProperties.toJSON()`. */
         interface DocumentPropertiesData {
             /**
-            * Gets the collection of custom properties of the workbook. Read only.
+            * Gets the collection of custom properties of the workbook.
             *
             * @remarks
             * [Api set: ExcelApi 1.7]
@@ -68169,7 +68538,7 @@ declare namespace Excel {
              */
             company?: string;
             /**
-             * Gets the creation date of the workbook. Read only.
+             * Gets the creation date of the workbook.
              *
              * @remarks
              * [Api set: ExcelApi 1.7]
@@ -68183,7 +68552,7 @@ declare namespace Excel {
              */
             keywords?: string;
             /**
-             * Gets the last author of the workbook. Read only.
+             * Gets the last author of the workbook.
              *
              * @remarks
              * [Api set: ExcelApi 1.7]
@@ -68197,7 +68566,7 @@ declare namespace Excel {
              */
             manager?: string;
             /**
-             * Gets the revision number of the workbook. Read only.
+             * Gets the revision number of the workbook.
              *
              * @remarks
              * [Api set: ExcelApi 1.7]
@@ -71757,6 +72126,15 @@ declare namespace Excel {
              * [Api set: ExcelApi 1.1]
              */
             values?: boolean;
+            /**
+             * A JSON representation of the values in the cells in this range.
+                        Unlike `Range.values`, `Range.valuesAsJson` supports all data types which can be in a cell.
+             *
+             * @remarks
+             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+             * @beta
+             */
+            valuesAsJson?: boolean;
             /**
              * Returns the distance in points, for 100% zoom, from the left edge of the range to the right edge of the range.
              *
@@ -71957,6 +72335,15 @@ declare namespace Excel {
              * [Api set: ExcelApi 1.3]
              */
             values?: boolean;
+            /**
+             * A JSON representation of the values in the cells in this range.
+                        Unlike `RangeView.values`, `RangeView.valuesAsJson` supports all data types which can be in a cell.
+             *
+             * @remarks
+             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+             * @beta
+             */
+            valuesAsJson?: boolean;
         }
         /**
          * Represents a collection of `RangeView` objects.
@@ -72046,6 +72433,15 @@ declare namespace Excel {
              * [Api set: ExcelApi 1.3]
              */
             values?: boolean;
+            /**
+             * For EACH ITEM in the collection: A JSON representation of the values in the cells in this range.
+                        Unlike `RangeView.values`, `RangeView.valuesAsJson` supports all data types which can be in a cell.
+             *
+             * @remarks
+             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+             * @beta
+             */
+            valuesAsJson?: boolean;
         }
         /**
          * Represents a collection of key-value pair setting objects that are part of the workbook. The scope is limited to per file and add-in (task-pane or content) combination.
@@ -72125,7 +72521,7 @@ declare namespace Excel {
             */
             worksheet?: Excel.Interfaces.WorksheetLoadOptions;
             /**
-            * For EACH ITEM in the collection: Returns the worksheet to which the named item is scoped. If the item is scoped to the workbook instead, then this function will return an object with its `isNullObject` property set to `true`.
+            * For EACH ITEM in the collection: Returns the worksheet to which the named item is scoped. If the item is scoped to the workbook instead, then this method returns an object with its `isNullObject` property set to `true`.
             For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
             *
             * @remarks
@@ -72174,6 +72570,15 @@ declare namespace Excel {
              * [Api set: ExcelApi 1.1]
              */
             value?: boolean;
+            /**
+             * For EACH ITEM in the collection: A JSON representation of the values in this named item.
+                        Unlike `NamedItem.value`, `NamedItem.valueAsJson` supports all data types which can be in a cell.
+             *
+             * @remarks
+             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+             * @beta
+             */
+            valueAsJson?: boolean;
             /**
              * For EACH ITEM in the collection: Specifies if the object is visible.
              *
@@ -72208,7 +72613,7 @@ declare namespace Excel {
             */
             worksheet?: Excel.Interfaces.WorksheetLoadOptions;
             /**
-            * Returns the worksheet to which the named item is scoped. If the item is scoped to the workbook instead, then this function will return an object with its `isNullObject` property set to `true`.
+            * Returns the worksheet to which the named item is scoped. If the item is scoped to the workbook instead, then this method returns an object with its `isNullObject` property set to `true`.
             For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
             *
             * @remarks
@@ -72257,6 +72662,15 @@ declare namespace Excel {
              * [Api set: ExcelApi 1.1]
              */
             value?: boolean;
+            /**
+             * A JSON representation of the values in this named item.
+                        Unlike `NamedItem.value`, `NamedItem.valueAsJson` supports all data types which can be in a cell.
+             *
+             * @remarks
+             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+             * @beta
+             */
+            valueAsJson?: boolean;
             /**
              * Specifies if the object is visible.
              *
@@ -72290,6 +72704,15 @@ declare namespace Excel {
              * [Api set: ExcelApi 1.7]
              */
             values?: boolean;
+            /**
+             * A JSON representation of the values in the cells in this range.
+                        Unlike `NamedItemArrayValues.values`, `NamedItemArrayValues.valuesAsJson` supports all data types which can be in a cell.
+             *
+             * @remarks
+             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+             * @beta
+             */
+            valuesAsJson?: boolean;
         }
         /**
          * Represents an Office.js binding that is defined in the workbook.
@@ -72793,6 +73216,15 @@ declare namespace Excel {
              * [Api set: ExcelApi 1.1]
              */
             values?: boolean;
+            /**
+             * For EACH ITEM in the collection: A JSON representation of the values in the cells in this table column.
+                        Unlike `TableColumn.values`, `TableColumn.valuesAsJson` supports all data types which can be in a cell.
+             *
+             * @remarks
+             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+             * @beta
+             */
+            valuesAsJson?: boolean;
         }
         /**
          * Represents a column in a table.
@@ -72841,6 +73273,15 @@ declare namespace Excel {
              * [Api set: ExcelApi 1.1]
              */
             values?: boolean;
+            /**
+             * A JSON representation of the values in the cells in this table column.
+                        Unlike `TableColumn.values`, `TableColumn.valuesAsJson` supports all data types which can be in a cell.
+             *
+             * @remarks
+             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+             * @beta
+             */
+            valuesAsJson?: boolean;
         }
         /**
          * Represents a collection of all the rows that are part of the table.
@@ -72873,6 +73314,15 @@ declare namespace Excel {
              * [Api set: ExcelApi 1.1]
              */
             values?: boolean;
+            /**
+             * For EACH ITEM in the collection: A JSON representation of the values in the cells in this table row.
+                        Unlike `TableRow.values`, `TableRow.valuesAsJson` supports all data types which can be in a cell.
+             *
+             * @remarks
+             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+             * @beta
+             */
+            valuesAsJson?: boolean;
         }
         /**
          * Represents a row in a table.
@@ -72905,6 +73355,15 @@ declare namespace Excel {
              * [Api set: ExcelApi 1.1]
              */
             values?: boolean;
+            /**
+             * A JSON representation of the values in the cells in this table row.
+                        Unlike `TableRow.values`, `TableRow.valuesAsJson` supports all data types which can be in a cell.
+             *
+             * @remarks
+             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+             * @beta
+             */
+            valuesAsJson?: boolean;
         }
         /**
          * Represents the data validation applied to the current range.
@@ -77779,7 +78238,7 @@ declare namespace Excel {
              */
             company?: boolean;
             /**
-             * Gets the creation date of the workbook. Read only.
+             * Gets the creation date of the workbook.
              *
              * @remarks
              * [Api set: ExcelApi 1.7]
@@ -77793,7 +78252,7 @@ declare namespace Excel {
              */
             keywords?: boolean;
             /**
-             * Gets the last author of the workbook. Read only.
+             * Gets the last author of the workbook.
              *
              * @remarks
              * [Api set: ExcelApi 1.7]
@@ -77807,7 +78266,7 @@ declare namespace Excel {
              */
             manager?: boolean;
             /**
-             * Gets the revision number of the workbook. Read only.
+             * Gets the revision number of the workbook.
              *
              * @remarks
              * [Api set: ExcelApi 1.7]
@@ -79878,6 +80337,15 @@ declare namespace Excel {
              * [Api set: ExcelApi 1.1]
              */
             values?: boolean;
+            /**
+             * For EACH ITEM in the collection: A JSON representation of the values in the cells in this range.
+                        Unlike `Range.values`, `Range.valuesAsJson` supports all data types which can be in a cell.
+             *
+             * @remarks
+             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+             * @beta
+             */
+            valuesAsJson?: boolean;
             /**
              * For EACH ITEM in the collection: Returns the distance in points, for 100% zoom, from the left edge of the range to the right edge of the range.
              *
@@ -80331,7 +80799,7 @@ declare namespace Excel {
             */
             parentGroup?: Excel.Interfaces.ShapeLoadOptions;
             /**
-            * For EACH ITEM in the collection: Returns the text frame object of this shape. Read only.
+            * For EACH ITEM in the collection: Returns the text frame object of this shape.
             *
             * @remarks
             * [Api set: ExcelApi 1.9]
@@ -80533,7 +81001,7 @@ declare namespace Excel {
             */
             parentGroup?: Excel.Interfaces.ShapeLoadOptions;
             /**
-            * Returns the text frame object of this shape. Read only.
+            * Returns the text frame object of this shape.
             *
             * @remarks
             * [Api set: ExcelApi 1.9]
@@ -80819,7 +81287,7 @@ declare namespace Excel {
             */
             parentGroup?: Excel.Interfaces.ShapeLoadOptions;
             /**
-            * For EACH ITEM in the collection: Returns the text frame object of this shape. Read only.
+            * For EACH ITEM in the collection: Returns the text frame object of this shape.
             *
             * @remarks
             * [Api set: ExcelApi 1.9]