word package

Classes

Word.Application	Represents the application object.
Word.Body	Represents the body of a document or a section.
Word.Comment	Represents a comment in the document.
Word.CommentCollection	Contains a collection of Word.Comment objects.
Word.CommentContentRange
Word.CommentReply	Represents a comment reply in the document.
Word.CommentReplyCollection	Contains a collection of Word.CommentReply objects. Represents all comment replies in one comment thread.
Word.ContentControl	Represents a content control. Content controls are bounded and potentially labeled regions in a document that serve as containers for specific types of content. Individual content controls may contain contents such as images, tables, or paragraphs of formatted text. Currently, only rich text, plain text, and checkbox content controls are supported.
Word.ContentControlCollection	Contains a collection of Word.ContentControl objects. Content controls are bounded and potentially labeled regions in a document that serve as containers for specific types of content. Individual content controls may contain contents such as images, tables, or paragraphs of formatted text. Currently, only rich text and plain text content controls are supported.
Word.CustomProperty	Represents a custom property.
Word.CustomPropertyCollection	Contains the collection of Word.CustomProperty objects.
Word.CustomXmlPart	Represents a custom XML part.
Word.CustomXmlPartCollection	Contains the collection of Word.CustomXmlPart objects.
Word.CustomXmlPartScopedCollection	Contains the collection of Word.CustomXmlPart objects with a specific namespace.
Word.Document	The Document object is the top level object. A Document object contains one or more sections, content controls, and the body that contains the contents of the document.
Word.DocumentCreated	The DocumentCreated object is the top level object created by Application.CreateDocument. A DocumentCreated object is a special Document object.
Word.DocumentProperties	Represents document properties.
Word.Field	Represents a field.
Word.FieldCollection	Contains a collection of Word.Field objects.
Word.Font	Represents a font.
Word.InlinePicture	Represents an inline picture.
Word.InlinePictureCollection	Contains a collection of Word.InlinePicture objects.
Word.List	Contains a collection of Word.Paragraph objects.
Word.ListCollection	Contains a collection of Word.List objects.
Word.ListItem	Represents the paragraph list item format.
Word.NoteItem	Represents a footnote or endnote.
Word.NoteItemCollection	Contains a collection of Word.NoteItem objects.
Word.Paragraph	Represents a single paragraph in a selection, range, content control, or document body.
Word.ParagraphCollection	Contains a collection of Word.Paragraph objects.
Word.ParagraphFormat	Represents a style of paragraph in a document.
Word.Range	Represents a contiguous area in a document.
Word.RangeCollection	Contains a collection of Word.Range objects.
Word.RequestContext	The RequestContext object facilitates requests to the Word application. Since the Office add-in and the Word application run in two different processes, the request context is required to get access to the Word object model from the add-in.
Word.SearchOptions	Specifies the options to be included in a search operation. To learn more about how to use search options in the Word JavaScript APIs, read Use search options to find text in your Word add-in.
Word.Section	Represents a section in a Word document.
Word.SectionCollection	Contains the collection of the document's Word.Section objects.
Word.Setting	Represents a setting of the add-in.
Word.SettingCollection	Contains the collection of Word.Setting objects.
Word.Style	Represents a style in a Word document.
Word.StyleCollection	Contains a collection of Word.Style objects.
Word.Table	Represents a table in a Word document.
Word.TableBorder	Specifies the border style.
Word.TableCell	Represents a table cell in a Word document.
Word.TableCellCollection	Contains the collection of the document's TableCell objects.
Word.TableCollection	Contains the collection of the document's Table objects.
Word.TableRow	Represents a row in a Word document.
Word.TableRowCollection	Contains the collection of the document's TableRow objects.

Interfaces

Word.ContentControlAddedEventArgs	Provides information about the content control that raised contentControlAdded event.
Word.ContentControlDataChangedEventArgs	Provides information about the content control that raised contentControlDataChanged event.
Word.ContentControlDeletedEventArgs	Provides information about the content control that raised contentControlDeleted event.
Word.ContentControlEnteredEventArgs	Provides information about the content control that raised contentControlEntered event.
Word.ContentControlExitedEventArgs	Provides information about the content control that raised contentControlExited event.
Word.ContentControlOptions	Specifies the options that define which content controls are returned.
Word.ContentControlSelectionChangedEventArgs	Provides information about the content control that raised contentControlSelectionChanged event.
Word.InsertFileOptions	Specifies the options to determine what to copy when inserting a file.
Word.Interfaces.AnnotationCollectionData	An interface describing the data returned by calling annotationCollection.toJSON().
Word.Interfaces.AnnotationCollectionUpdateData	An interface for updating data on the AnnotationCollection object, for use in annotationCollection.set({ ... }).
Word.Interfaces.AnnotationData	An interface describing the data returned by calling annotation.toJSON().
Word.Interfaces.BodyData	An interface describing the data returned by calling body.toJSON().
Word.Interfaces.BodyLoadOptions	Represents the body of a document or a section.
Word.Interfaces.BodyUpdateData	An interface for updating data on the Body object, for use in body.set({ ... }).
Word.Interfaces.BorderCollectionData	An interface describing the data returned by calling borderCollection.toJSON().
Word.Interfaces.BorderCollectionUpdateData	An interface for updating data on the BorderCollection object, for use in borderCollection.set({ ... }).
Word.Interfaces.BorderData	An interface describing the data returned by calling border.toJSON().
Word.Interfaces.BorderUpdateData	An interface for updating data on the Border object, for use in border.set({ ... }).
Word.Interfaces.CheckboxContentControlData	An interface describing the data returned by calling checkboxContentControl.toJSON().
Word.Interfaces.CheckboxContentControlUpdateData	An interface for updating data on the CheckboxContentControl object, for use in checkboxContentControl.set({ ... }).
Word.Interfaces.CollectionLoadOptions	Provides ways to load properties of only a subset of members of a collection.
Word.Interfaces.CommentCollectionData	An interface describing the data returned by calling commentCollection.toJSON().
Word.Interfaces.CommentCollectionLoadOptions	Contains a collection of Word.Comment objects.
Word.Interfaces.CommentCollectionUpdateData	An interface for updating data on the CommentCollection object, for use in commentCollection.set({ ... }).
Word.Interfaces.CommentContentRangeData	An interface describing the data returned by calling commentContentRange.toJSON().
Word.Interfaces.CommentContentRangeLoadOptions
Word.Interfaces.CommentContentRangeUpdateData	An interface for updating data on the CommentContentRange object, for use in commentContentRange.set({ ... }).
Word.Interfaces.CommentData	An interface describing the data returned by calling comment.toJSON().
Word.Interfaces.CommentLoadOptions	Represents a comment in the document.
Word.Interfaces.CommentReplyCollectionData	An interface describing the data returned by calling commentReplyCollection.toJSON().
Word.Interfaces.CommentReplyCollectionLoadOptions	Contains a collection of Word.CommentReply objects. Represents all comment replies in one comment thread.
Word.Interfaces.CommentReplyCollectionUpdateData	An interface for updating data on the CommentReplyCollection object, for use in commentReplyCollection.set({ ... }).
Word.Interfaces.CommentReplyData	An interface describing the data returned by calling commentReply.toJSON().
Word.Interfaces.CommentReplyLoadOptions	Represents a comment reply in the document.
Word.Interfaces.CommentReplyUpdateData	An interface for updating data on the CommentReply object, for use in commentReply.set({ ... }).
Word.Interfaces.CommentUpdateData	An interface for updating data on the Comment object, for use in comment.set({ ... }).
Word.Interfaces.ContentControlCollectionData	An interface describing the data returned by calling contentControlCollection.toJSON().
Word.Interfaces.ContentControlCollectionLoadOptions	Contains a collection of Word.ContentControl objects. Content controls are bounded and potentially labeled regions in a document that serve as containers for specific types of content. Individual content controls may contain contents such as images, tables, or paragraphs of formatted text. Currently, only rich text and plain text content controls are supported.
Word.Interfaces.ContentControlCollectionUpdateData	An interface for updating data on the ContentControlCollection object, for use in contentControlCollection.set({ ... }).
Word.Interfaces.ContentControlData	An interface describing the data returned by calling contentControl.toJSON().
Word.Interfaces.ContentControlLoadOptions	Represents a content control. Content controls are bounded and potentially labeled regions in a document that serve as containers for specific types of content. Individual content controls may contain contents such as images, tables, or paragraphs of formatted text. Currently, only rich text, plain text, and checkbox content controls are supported.
Word.Interfaces.ContentControlUpdateData	An interface for updating data on the ContentControl object, for use in contentControl.set({ ... }).
Word.Interfaces.CritiqueAnnotationData	An interface describing the data returned by calling critiqueAnnotation.toJSON().
Word.Interfaces.CustomPropertyCollectionData	An interface describing the data returned by calling customPropertyCollection.toJSON().
Word.Interfaces.CustomPropertyCollectionLoadOptions	Contains the collection of Word.CustomProperty objects.
Word.Interfaces.CustomPropertyCollectionUpdateData	An interface for updating data on the CustomPropertyCollection object, for use in customPropertyCollection.set({ ... }).
Word.Interfaces.CustomPropertyData	An interface describing the data returned by calling customProperty.toJSON().
Word.Interfaces.CustomPropertyLoadOptions	Represents a custom property.
Word.Interfaces.CustomPropertyUpdateData	An interface for updating data on the CustomProperty object, for use in customProperty.set({ ... }).
Word.Interfaces.CustomXmlPartCollectionData	An interface describing the data returned by calling customXmlPartCollection.toJSON().
Word.Interfaces.CustomXmlPartCollectionLoadOptions	Contains the collection of Word.CustomXmlPart objects.
Word.Interfaces.CustomXmlPartCollectionUpdateData	An interface for updating data on the CustomXmlPartCollection object, for use in customXmlPartCollection.set({ ... }).
Word.Interfaces.CustomXmlPartData	An interface describing the data returned by calling customXmlPart.toJSON().
Word.Interfaces.CustomXmlPartLoadOptions	Represents a custom XML part.
Word.Interfaces.CustomXmlPartScopedCollectionData	An interface describing the data returned by calling customXmlPartScopedCollection.toJSON().
Word.Interfaces.CustomXmlPartScopedCollectionLoadOptions	Contains the collection of Word.CustomXmlPart objects with a specific namespace.
Word.Interfaces.CustomXmlPartScopedCollectionUpdateData	An interface for updating data on the CustomXmlPartScopedCollection object, for use in customXmlPartScopedCollection.set({ ... }).
Word.Interfaces.DocumentCreatedData	An interface describing the data returned by calling documentCreated.toJSON().
Word.Interfaces.DocumentCreatedLoadOptions	The DocumentCreated object is the top level object created by Application.CreateDocument. A DocumentCreated object is a special Document object.
Word.Interfaces.DocumentCreatedUpdateData	An interface for updating data on the DocumentCreated object, for use in documentCreated.set({ ... }).
Word.Interfaces.DocumentData	An interface describing the data returned by calling document.toJSON().
Word.Interfaces.DocumentLoadOptions	The Document object is the top level object. A Document object contains one or more sections, content controls, and the body that contains the contents of the document.
Word.Interfaces.DocumentPropertiesData	An interface describing the data returned by calling documentProperties.toJSON().
Word.Interfaces.DocumentPropertiesLoadOptions	Represents document properties.
Word.Interfaces.DocumentPropertiesUpdateData	An interface for updating data on the DocumentProperties object, for use in documentProperties.set({ ... }).
Word.Interfaces.DocumentUpdateData	An interface for updating data on the Document object, for use in document.set({ ... }).
Word.Interfaces.FieldCollectionData	An interface describing the data returned by calling fieldCollection.toJSON().
Word.Interfaces.FieldCollectionLoadOptions	Contains a collection of Word.Field objects.
Word.Interfaces.FieldCollectionUpdateData	An interface for updating data on the FieldCollection object, for use in fieldCollection.set({ ... }).
Word.Interfaces.FieldData	An interface describing the data returned by calling field.toJSON().
Word.Interfaces.FieldLoadOptions	Represents a field.
Word.Interfaces.FieldUpdateData	An interface for updating data on the Field object, for use in field.set({ ... }).
Word.Interfaces.FontData	An interface describing the data returned by calling font.toJSON().
Word.Interfaces.FontLoadOptions	Represents a font.
Word.Interfaces.FontUpdateData	An interface for updating data on the Font object, for use in font.set({ ... }).
Word.Interfaces.InlinePictureCollectionData	An interface describing the data returned by calling inlinePictureCollection.toJSON().
Word.Interfaces.InlinePictureCollectionLoadOptions	Contains a collection of Word.InlinePicture objects.
Word.Interfaces.InlinePictureCollectionUpdateData	An interface for updating data on the InlinePictureCollection object, for use in inlinePictureCollection.set({ ... }).
Word.Interfaces.InlinePictureData	An interface describing the data returned by calling inlinePicture.toJSON().
Word.Interfaces.InlinePictureLoadOptions	Represents an inline picture.
Word.Interfaces.InlinePictureUpdateData	An interface for updating data on the InlinePicture object, for use in inlinePicture.set({ ... }).
Word.Interfaces.ListCollectionData	An interface describing the data returned by calling listCollection.toJSON().
Word.Interfaces.ListCollectionLoadOptions	Contains a collection of Word.List objects.
Word.Interfaces.ListCollectionUpdateData	An interface for updating data on the ListCollection object, for use in listCollection.set({ ... }).
Word.Interfaces.ListData	An interface describing the data returned by calling list.toJSON().
Word.Interfaces.ListItemData	An interface describing the data returned by calling listItem.toJSON().
Word.Interfaces.ListItemLoadOptions	Represents the paragraph list item format.
Word.Interfaces.ListItemUpdateData	An interface for updating data on the ListItem object, for use in listItem.set({ ... }).
Word.Interfaces.ListLevelCollectionData	An interface describing the data returned by calling listLevelCollection.toJSON().
Word.Interfaces.ListLevelCollectionUpdateData	An interface for updating data on the ListLevelCollection object, for use in listLevelCollection.set({ ... }).
Word.Interfaces.ListLevelData	An interface describing the data returned by calling listLevel.toJSON().
Word.Interfaces.ListLevelUpdateData	An interface for updating data on the ListLevel object, for use in listLevel.set({ ... }).
Word.Interfaces.ListLoadOptions	Contains a collection of Word.Paragraph objects.
Word.Interfaces.ListTemplateData	An interface describing the data returned by calling listTemplate.toJSON().
Word.Interfaces.ListTemplateUpdateData	An interface for updating data on the ListTemplate object, for use in listTemplate.set({ ... }).
Word.Interfaces.NoteItemCollectionData	An interface describing the data returned by calling noteItemCollection.toJSON().
Word.Interfaces.NoteItemCollectionLoadOptions	Contains a collection of Word.NoteItem objects.
Word.Interfaces.NoteItemCollectionUpdateData	An interface for updating data on the NoteItemCollection object, for use in noteItemCollection.set({ ... }).
Word.Interfaces.NoteItemData	An interface describing the data returned by calling noteItem.toJSON().
Word.Interfaces.NoteItemLoadOptions	Represents a footnote or endnote.
Word.Interfaces.NoteItemUpdateData	An interface for updating data on the NoteItem object, for use in noteItem.set({ ... }).
Word.Interfaces.ParagraphCollectionData	An interface describing the data returned by calling paragraphCollection.toJSON().
Word.Interfaces.ParagraphCollectionLoadOptions	Contains a collection of Word.Paragraph objects.
Word.Interfaces.ParagraphCollectionUpdateData	An interface for updating data on the ParagraphCollection object, for use in paragraphCollection.set({ ... }).
Word.Interfaces.ParagraphData	An interface describing the data returned by calling paragraph.toJSON().
Word.Interfaces.ParagraphFormatData	An interface describing the data returned by calling paragraphFormat.toJSON().
Word.Interfaces.ParagraphFormatLoadOptions	Represents a style of paragraph in a document.
Word.Interfaces.ParagraphFormatUpdateData	An interface for updating data on the ParagraphFormat object, for use in paragraphFormat.set({ ... }).
Word.Interfaces.ParagraphLoadOptions	Represents a single paragraph in a selection, range, content control, or document body.
Word.Interfaces.ParagraphUpdateData	An interface for updating data on the Paragraph object, for use in paragraph.set({ ... }).
Word.Interfaces.RangeCollectionData	An interface describing the data returned by calling rangeCollection.toJSON().
Word.Interfaces.RangeCollectionLoadOptions	Contains a collection of Word.Range objects.
Word.Interfaces.RangeCollectionUpdateData	An interface for updating data on the RangeCollection object, for use in rangeCollection.set({ ... }).
Word.Interfaces.RangeData	An interface describing the data returned by calling range.toJSON().
Word.Interfaces.RangeLoadOptions	Represents a contiguous area in a document.
Word.Interfaces.RangeUpdateData	An interface for updating data on the Range object, for use in range.set({ ... }).
Word.Interfaces.SearchOptionsData	An interface describing the data returned by calling searchOptions.toJSON().
Word.Interfaces.SearchOptionsLoadOptions	Specifies the options to be included in a search operation. To learn more about how to use search options in the Word JavaScript APIs, read Use search options to find text in your Word add-in.
Word.Interfaces.SearchOptionsUpdateData	An interface for updating data on the SearchOptions object, for use in searchOptions.set({ ... }).
Word.Interfaces.SectionCollectionData	An interface describing the data returned by calling sectionCollection.toJSON().
Word.Interfaces.SectionCollectionLoadOptions	Contains the collection of the document's Word.Section objects.
Word.Interfaces.SectionCollectionUpdateData	An interface for updating data on the SectionCollection object, for use in sectionCollection.set({ ... }).
Word.Interfaces.SectionData	An interface describing the data returned by calling section.toJSON().
Word.Interfaces.SectionLoadOptions	Represents a section in a Word document.
Word.Interfaces.SectionUpdateData	An interface for updating data on the Section object, for use in section.set({ ... }).
Word.Interfaces.SettingCollectionData	An interface describing the data returned by calling settingCollection.toJSON().
Word.Interfaces.SettingCollectionLoadOptions	Contains the collection of Word.Setting objects.
Word.Interfaces.SettingCollectionUpdateData	An interface for updating data on the SettingCollection object, for use in settingCollection.set({ ... }).
Word.Interfaces.SettingData	An interface describing the data returned by calling setting.toJSON().
Word.Interfaces.SettingLoadOptions	Represents a setting of the add-in.
Word.Interfaces.SettingUpdateData	An interface for updating data on the Setting object, for use in setting.set({ ... }).
Word.Interfaces.ShadingData	An interface describing the data returned by calling shading.toJSON().
Word.Interfaces.ShadingUpdateData	An interface for updating data on the Shading object, for use in shading.set({ ... }).
Word.Interfaces.StyleCollectionData	An interface describing the data returned by calling styleCollection.toJSON().
Word.Interfaces.StyleCollectionLoadOptions	Contains a collection of Word.Style objects.
Word.Interfaces.StyleCollectionUpdateData	An interface for updating data on the StyleCollection object, for use in styleCollection.set({ ... }).
Word.Interfaces.StyleData	An interface describing the data returned by calling style.toJSON().
Word.Interfaces.StyleLoadOptions	Represents a style in a Word document.
Word.Interfaces.StyleUpdateData	An interface for updating data on the Style object, for use in style.set({ ... }).
Word.Interfaces.TableBorderData	An interface describing the data returned by calling tableBorder.toJSON().
Word.Interfaces.TableBorderLoadOptions	Specifies the border style.
Word.Interfaces.TableBorderUpdateData	An interface for updating data on the TableBorder object, for use in tableBorder.set({ ... }).
Word.Interfaces.TableCellCollectionData	An interface describing the data returned by calling tableCellCollection.toJSON().
Word.Interfaces.TableCellCollectionLoadOptions	Contains the collection of the document's TableCell objects.
Word.Interfaces.TableCellCollectionUpdateData	An interface for updating data on the TableCellCollection object, for use in tableCellCollection.set({ ... }).
Word.Interfaces.TableCellData	An interface describing the data returned by calling tableCell.toJSON().
Word.Interfaces.TableCellLoadOptions	Represents a table cell in a Word document.
Word.Interfaces.TableCellUpdateData	An interface for updating data on the TableCell object, for use in tableCell.set({ ... }).
Word.Interfaces.TableCollectionData	An interface describing the data returned by calling tableCollection.toJSON().
Word.Interfaces.TableCollectionLoadOptions	Contains the collection of the document's Table objects.
Word.Interfaces.TableCollectionUpdateData	An interface for updating data on the TableCollection object, for use in tableCollection.set({ ... }).
Word.Interfaces.TableData	An interface describing the data returned by calling table.toJSON().
Word.Interfaces.TableLoadOptions	Represents a table in a Word document.
Word.Interfaces.TableRowCollectionData	An interface describing the data returned by calling tableRowCollection.toJSON().
Word.Interfaces.TableRowCollectionLoadOptions	Contains the collection of the document's TableRow objects.
Word.Interfaces.TableRowCollectionUpdateData	An interface for updating data on the TableRowCollection object, for use in tableRowCollection.set({ ... }).
Word.Interfaces.TableRowData	An interface describing the data returned by calling tableRow.toJSON().
Word.Interfaces.TableRowLoadOptions	Represents a row in a Word document.
Word.Interfaces.TableRowUpdateData	An interface for updating data on the TableRow object, for use in tableRow.set({ ... }).
Word.Interfaces.TableStyleData	An interface describing the data returned by calling tableStyle.toJSON().
Word.Interfaces.TableStyleUpdateData	An interface for updating data on the TableStyle object, for use in tableStyle.set({ ... }).
Word.Interfaces.TableUpdateData	An interface for updating data on the Table object, for use in table.set({ ... }).
Word.Interfaces.TrackedChangeCollectionData	An interface describing the data returned by calling trackedChangeCollection.toJSON().
Word.Interfaces.TrackedChangeCollectionUpdateData	An interface for updating data on the TrackedChangeCollection object, for use in trackedChangeCollection.set({ ... }).
Word.Interfaces.TrackedChangeData	An interface describing the data returned by calling trackedChange.toJSON().

Enums

Word.Alignment
Word.BodyType
Word.BorderLocation
Word.BorderType
Word.BreakType	Specifies the form of a break.
Word.BuiltInStyleName	Represents the built-in style in a Word document.
Word.CellPaddingLocation
Word.ChangeTrackingMode	ChangeTracking mode.
Word.ChangeTrackingState	Specify the track state when ChangeTracking is on.
Word.ChangeTrackingVersion	Specify the current version or the original version of the text.
Word.CloseBehavior	Specifies the close behavior for Document.close.
Word.ContentControlAppearance	ContentControl appearance.
Word.ContentControlType	Specifies supported content control types and subtypes.
Word.DocumentPropertyType
Word.ErrorCodes
Word.EventSource	An enum that specifies an event's source. It can be local or remote (through coauthoring).
Word.EventType	Provides information about the type of a raised event.
Word.FieldKind	Represents the kind of field. Indicates how the field works in relation to updating.
Word.FieldType	Represents the type of Field.
Word.HeaderFooterType
Word.InsertLocation	The insertion location types.
Word.ListBullet
Word.ListLevelType
Word.ListNumbering
Word.LocationRelation
Word.NoteItemType	Note item type
Word.OutlineLevel	Represents the outline levels.
Word.RangeLocation
Word.SaveBehavior	Specifies the save behavior for Document.save.
Word.SelectionMode	This enum sets where the cursor (insertion point) in the document is after a selection.
Word.StyleType	Represents the type of style.
Word.UnderlineType	The supported styles for underline format.
Word.VerticalAlignment

Functions

Word.run(objects, batch)	Executes a batch script that performs actions on the Word object model, using the RequestContext of previously created API objects.
Word.run(object, batch)	Executes a batch script that performs actions on the Word object model, using the RequestContext of a previously created API object. When the promise is resolved, any tracked objects that were automatically allocated during execution will be released.
Word.run(batch)	Executes a batch script that performs actions on the Word object model, using a new RequestContext. When the promise is resolved, any tracked objects that were automatically allocated during execution will be released.

Function Details

Word.run(objects, batch)

Executes a batch script that performs actions on the Word object model, using the RequestContext of previously created API objects.

export function run<T>(objects: OfficeExtension.ClientObject[], batch: (context: Word.RequestContext) => Promise<T>): Promise<T>;

Parameters

objects

OfficeExtension.ClientObject[]

An array of previously created API objects. The array will be validated to make sure that all of the objects share the same context. The batch will use this shared RequestContext, which means that any changes applied to these objects will be picked up by context.sync().

batch

(context: Word.RequestContext) => Promise<T>

A function that takes in a RequestContext and returns a promise (typically, just the result of context.sync()). The context parameter facilitates requests to the Word application. Since the Office add-in and the Word application run in two different processes, the RequestContext is required to get access to the Word object model from the add-in.

Returns

Promise<T>

Word.run(object, batch)

Executes a batch script that performs actions on the Word object model, using the RequestContext of a previously created API object. When the promise is resolved, any tracked objects that were automatically allocated during execution will be released.

export function run<T>(object: OfficeExtension.ClientObject, batch: (context: Word.RequestContext) => Promise<T>): Promise<T>;

Parameters

object

OfficeExtension.ClientObject

A previously created API object. The batch will use the same RequestContext as the passed-in object, which means that any changes applied to the object will be picked up by context.sync().

batch

(context: Word.RequestContext) => Promise<T>

A function that takes in a RequestContext and returns a promise (typically, just the result of context.sync()). The context parameter facilitates requests to the Word application. Since the Office add-in and the Word application run in two different processes, the RequestContext is required to get access to the Word object model from the add-in.

Returns

Promise<T>

Word.run(batch)

Executes a batch script that performs actions on the Word object model, using a new RequestContext. When the promise is resolved, any tracked objects that were automatically allocated during execution will be released.

export function run<T>(batch: (context: Word.RequestContext) => Promise<T>): Promise<T>;

Parameters

batch

(context: Word.RequestContext) => Promise<T>

A function that takes in a RequestContext and returns a promise (typically, just the result of context.sync()). The context parameter facilitates requests to the Word application. Since the Office add-in and the Word application run in two different processes, the RequestContext is required to get access to the Word object model from the add-in.

Returns

Promise<T>