Word.DocumentCompareOptions interface
Specifies the options to be included in a compare document operation.
Remarks
[ API set: WordApiDesktop 1.1 ]
Examples
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/50-document/compare-documents.yaml
// Compares the current document with a specified external document.
await Word.run(async (context) => {
// Absolute path of an online or local document.
const filePath = $("#filePath")
.val()
.toString();
// Options that configure the compare operation.
const options: Word.DocumentCompareOptions = {
compareTarget: Word.CompareTarget.compareTargetCurrent,
detectFormatChanges: false
// Other options you choose...
};
context.document.compare(filePath, options);
await context.sync();
console.log("Differences shown in the current document.");
});
Properties
add |
True adds the document to the list of recently used files on the File menu. The default value is True. |
author |
The reviewer name associated with the differences generated by the comparison. If unspecified, the value defaults to the author name of the revised document or the string "Comparison" if no author information is present. |
compare |
The target document for the comparison. Default value is 'CompareTargetCurrent'. |
detect |
True (default) for the comparison to include detection of format changes. |
ignore |
True compares the documents without notifying a user of problems. The default value is False. |
remove |
True removes date and time stamp information from tracked changes in the returned Document object. The default value is False. |
remove |
True removes all user information from comments, revisions, and the properties dialog box in the returned Document object. The default value is False. |
Property Details
addToRecentFiles
True adds the document to the list of recently used files on the File menu. The default value is True.
addToRecentFiles?: boolean;
Property Value
boolean
Remarks
authorName
The reviewer name associated with the differences generated by the comparison. If unspecified, the value defaults to the author name of the revised document or the string "Comparison" if no author information is present.
authorName?: string;
Property Value
string
Remarks
compareTarget
The target document for the comparison. Default value is 'CompareTargetCurrent'.
compareTarget?: Word.CompareTarget | "CompareTargetCurrent" | "CompareTargetSelected" | "CompareTargetNew";
Property Value
Word.CompareTarget | "CompareTargetCurrent" | "CompareTargetSelected" | "CompareTargetNew"
Remarks
detectFormatChanges
True (default) for the comparison to include detection of format changes.
detectFormatChanges?: boolean;
Property Value
boolean
Remarks
ignoreAllComparisonWarnings
True compares the documents without notifying a user of problems. The default value is False.
ignoreAllComparisonWarnings?: boolean;
Property Value
boolean
Remarks
removeDateAndTime
True removes date and time stamp information from tracked changes in the returned Document object. The default value is False.
removeDateAndTime?: boolean;
Property Value
boolean
Remarks
removePersonalInformation
True removes all user information from comments, revisions, and the properties dialog box in the returned Document object. The default value is False.
removePersonalInformation?: boolean;
Property Value
boolean
Remarks
Office Add-ins