@groupdocs/groupdocs.comparison 25.6.0 → 25.11.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/End User License Agreement.html +7 -5
- package/README.md +203 -43
- package/package.json +3 -3
|
@@ -1,10 +1,12 @@
|
|
|
1
1
|
<html>
|
|
2
2
|
<head>
|
|
3
|
-
<title>GroupDocs - End User License Agreement (EULA)</title>
|
|
4
|
-
<meta http-equiv="refresh" content="0; url=https://
|
|
3
|
+
<title>GroupDocs - End User License Agreement (EULA)</title>
|
|
4
|
+
<meta http-equiv="refresh" content="0; url=https://about.groupdocs.com/legal/eula/" />
|
|
5
5
|
</head>
|
|
6
6
|
<body>
|
|
7
|
-
<p>Please wait. You
|
|
8
|
-
<p>If
|
|
7
|
+
<p>Please wait. You’ll be redirected to the online version of the EULA.</p>
|
|
8
|
+
<p>If the redirection does not occur automatically, please visit the following link:
|
|
9
|
+
<a href="https://about.groupdocs.com/legal/eula/">https://about.groupdocs.com/legal/eula/</a>
|
|
10
|
+
</p>
|
|
9
11
|
</body>
|
|
10
|
-
</html>
|
|
12
|
+
</html>
|
package/README.md
CHANGED
|
@@ -1,52 +1,212 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
-
|
|
6
|
-
-
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
**Microsoft
|
|
23
|
-
**Microsoft
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
**
|
|
31
|
-
**
|
|
32
|
-
**
|
|
33
|
-
**
|
|
34
|
-
**
|
|
35
|
-
|
|
36
|
-
|
|
1
|
+
Powerful document comparison API for Node.js (powered by Java) to diff 50+ document and image formats, including Microsoft Office and OpenDocument types, PDF documents, and common raster images (TIFF, JPEG, GIF, PNG, BMP). Retrieve changes in a convenient format with line-by-line comparison of content, paragraphs, characters, styles, shapes, and positions.
|
|
2
|
+
|
|
3
|
+
### Quick links
|
|
4
|
+
|
|
5
|
+
- [Release Notes](https://releases.groupdocs.com/comparison/nodejs-java/release-notes/)
|
|
6
|
+
- [Documentation](https://docs.groupdocs.com/comparison/nodejs-java/)
|
|
7
|
+
- [System Requirements](https://docs.groupdocs.com/comparison/nodejs-java/system-requirements/)
|
|
8
|
+
- [Installation Guide](https://docs.groupdocs.com/comparison/nodejs-java/installation/)
|
|
9
|
+
- [Support](https://forum.groupdocs.com/)
|
|
10
|
+
- [Pricing](https://purchase.groupdocs.com/pricing/comparison/nodejs-java/)
|
|
11
|
+
|
|
12
|
+
## Key Features
|
|
13
|
+
|
|
14
|
+
- Compare files or folders and detect differences in similar documents.
|
|
15
|
+
- Visually represent, list, approve, or reject changes.
|
|
16
|
+
- Popular document formats such as PDF, DOCX, PPTX, and XLSX are supported.
|
|
17
|
+
|
|
18
|
+
## Supported Formats
|
|
19
|
+
|
|
20
|
+
### Microsoft Office Formats
|
|
21
|
+
|
|
22
|
+
* **Microsoft Word:** DOC, DOCM, DOCX, DOT, DOTM, DOTX, RTF
|
|
23
|
+
* **Microsoft Excel:** XLS, XLT, XLSX, XLTM, XLSB, XLSM
|
|
24
|
+
* **Microsoft PowerPoint:** POT, POTX, PPS, PPSX, PPTX, PPT
|
|
25
|
+
* **Microsoft OneNote:** ONE
|
|
26
|
+
* **Microsoft Visio:** VSDX, VSD, VSS, VST, VDX
|
|
27
|
+
|
|
28
|
+
### Other Supported Formats
|
|
29
|
+
|
|
30
|
+
* **OpenDocument:** ODT, ODP, OTP, ODS, OTT
|
|
31
|
+
* **Portable:** PDF
|
|
32
|
+
* **AutoCAD:** DWG, DXF
|
|
33
|
+
* **Email:** EML, EMLX, MSG
|
|
34
|
+
* **Images:** BMP, GIF, JPG, JPEG, PNG, DICOM
|
|
35
|
+
* **Web:** HTM, HTML, MHT, MHTML
|
|
36
|
+
* **Text:** TXT, CSV
|
|
37
|
+
* **eBook:** MOBI, DJVU
|
|
38
|
+
|
|
39
|
+
## Getting Started
|
|
40
|
+
|
|
41
|
+
### Prerequisites
|
|
42
|
+
|
|
43
|
+
- Node.js (LTS recommended)
|
|
44
|
+
- Java Runtime Environment (JRE) 8 or later
|
|
45
|
+
- Windows, Linux, or macOS
|
|
46
|
+
|
|
37
47
|
### Installation
|
|
38
48
|
|
|
39
|
-
|
|
49
|
+
To install the package, check the [System Requirements](https://docs.groupdocs.com/comparison/nodejs-java/system-requirements/) and [Installation](https://docs.groupdocs.com/comparison/nodejs-java/installation/) documentation topics for platform-specific instructions.
|
|
50
|
+
|
|
51
|
+
### Use cases
|
|
40
52
|
|
|
41
|
-
|
|
53
|
+
Here are some typical use cases:
|
|
42
54
|
|
|
43
|
-
### Compare
|
|
55
|
+
### Compare files
|
|
56
|
+
|
|
57
|
+
This example shows how to compare two DOCX files and save a diff file.
|
|
44
58
|
|
|
45
59
|
```js
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
60
|
+
'use strict';
|
|
61
|
+
|
|
62
|
+
const groupdocs = require('@groupdocs/groupdocs.comparison');
|
|
63
|
+
|
|
64
|
+
// Apply license, required for non-evaluation usage
|
|
65
|
+
const license = new groupdocs.License();
|
|
66
|
+
license.setLicense("GroupDocs.Comparison.lic");
|
|
67
|
+
|
|
68
|
+
// Compare documents
|
|
69
|
+
const comparer = new groupdocs.Comparer("proposal_v1.docx");
|
|
70
|
+
comparer.add("proposal_v2.docx");
|
|
71
|
+
comparer.compare("proposal_diff.docx");
|
|
72
|
+
|
|
73
|
+
// Exit
|
|
74
|
+
process.exit(0);
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
The output `proposal_diff.docx` file shows changes made in the second version of the file and lists all the changes on an additional summary page.
|
|
78
|
+
|
|
79
|
+
### Get changes
|
|
80
|
+
|
|
81
|
+
```javascript
|
|
82
|
+
'use strict';
|
|
83
|
+
|
|
84
|
+
const groupdocs = require('@groupdocs/groupdocs.comparison');
|
|
85
|
+
|
|
86
|
+
// Apply license, required for non-evaluation usage
|
|
87
|
+
const license = new groupdocs.License();
|
|
88
|
+
license.setLicense("GroupDocs.Comparison.lic");
|
|
89
|
+
|
|
90
|
+
// Compare documents
|
|
91
|
+
const comparer = new groupdocs.Comparer("proposal_v1.docx");
|
|
92
|
+
comparer.add("proposal_v2.docx");
|
|
93
|
+
comparer.compare();
|
|
94
|
+
|
|
95
|
+
// Print out changes
|
|
96
|
+
const changes = comparer.getChanges();
|
|
97
|
+
for (let index = 0; index < changes.length; index++) {
|
|
98
|
+
const change = changes[index];
|
|
99
|
+
|
|
100
|
+
const page = change.getPageInfo().getPageNumber();
|
|
101
|
+
const type = change.getType().name();
|
|
102
|
+
const text = (change.getText() || "").trim();
|
|
103
|
+
const src = (change.getSourceText() || "").trim();
|
|
104
|
+
const tgt = (change.getTargetText() || "").trim();
|
|
105
|
+
|
|
106
|
+
console.log(`[Page ${page}] ${type} "${text}", "${src}" -> "${tgt}"`);
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
// Exit
|
|
110
|
+
process.exit(0);
|
|
49
111
|
```
|
|
50
112
|
|
|
113
|
+
This code example compares two DOCX files and outputs details on changes, such as page, change type, source, and changed text. See the expected console output:
|
|
114
|
+
|
|
115
|
+
```log
|
|
116
|
+
[Page 3] INSERTED "7", "$12 per user/month" -> "$7 per user/month"
|
|
117
|
+
[Page 3] DELETED "12", "$12 per user/month" -> "$7 per user/month"
|
|
118
|
+
[Page 3] DELETED "5", "$25 per user/month" -> "$20 per user/month"
|
|
119
|
+
[Page 3] INSERTED "0", "$25 per user/month" -> "$20 per user/month"
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
### Accept or reject changes
|
|
123
|
+
|
|
124
|
+
This code example shows how to accept or reject changes between two versions of the same document.
|
|
125
|
+
|
|
126
|
+
```javascript
|
|
127
|
+
'use strict';
|
|
128
|
+
|
|
129
|
+
const java = require('java');
|
|
130
|
+
|
|
131
|
+
const groupdocs = require('@groupdocs/groupdocs.comparison');
|
|
132
|
+
|
|
133
|
+
// Apply license, required for non-evaluation usage
|
|
134
|
+
const license = new groupdocs.License()
|
|
135
|
+
license.setLicense("GroupDocs.Comparison.lic");
|
|
136
|
+
|
|
137
|
+
// Compare documents
|
|
138
|
+
const comparer = new groupdocs.Comparer("proposal_v1.docx");
|
|
139
|
+
comparer.add("proposal_v2.docx");
|
|
140
|
+
comparer.compare();
|
|
141
|
+
|
|
142
|
+
// Accept all chanes
|
|
143
|
+
const changes = comparer.getChanges();
|
|
144
|
+
for (let index = 0; index < changes.length; index++) {
|
|
145
|
+
const change = changes[index];
|
|
146
|
+
change.setComparisonAction(groupdocs.ComparisonAction.ACCEPT); // or REJECT
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
// Apply changes and save result
|
|
150
|
+
const changeArray = java.newArray('com.groupdocs.comparison.result.ChangeInfo', changes);
|
|
151
|
+
const saveOptions = new groupdocs.ApplyChangeOptions(changeArray);
|
|
152
|
+
comparer.applyChanges("proposal_accepted_changes.docx", saveOptions);
|
|
153
|
+
|
|
154
|
+
// Exit
|
|
155
|
+
process.exit(0);
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
This example accepts all the changes and saves the output file with all changes accepted.
|
|
159
|
+
|
|
160
|
+
## Troubleshooting
|
|
161
|
+
|
|
162
|
+
- Download during installation fails (corporate proxy/firewall): Ensure your environment allows downloading the required JAR during `postinstall`. If needed, download the file manually to the `lib/` directory as described in the [Installation Guide](https://docs.groupdocs.com/comparison/nodejs-java/installation/).
|
|
163
|
+
- Java not found: Make sure Java (JRE 8+) is installed and available on your system `PATH`.
|
|
164
|
+
- Permission issues when writing output files: Verify your process has write access to the target directory.
|
|
165
|
+
|
|
166
|
+
## Licensing
|
|
167
|
+
|
|
168
|
+
For testing without trial limitations, you can request a 30-day Temporary License:
|
|
169
|
+
|
|
170
|
+
* Visit the [Get a Temporary License](https://purchase.groupdocs.com/temporary-license/) page
|
|
171
|
+
* Follow the instructions to request your temporary license
|
|
172
|
+
* Copy the license file and apply it using the code example
|
|
173
|
+
|
|
174
|
+
```javascript
|
|
175
|
+
'use strict';
|
|
176
|
+
|
|
177
|
+
const groupdocs = require('@groupdocs/groupdocs.comparison');
|
|
178
|
+
|
|
179
|
+
// Apply license
|
|
180
|
+
const license = new groupdocs.License();
|
|
181
|
+
license.setLicense("GroupDocs.Comparison.lic");
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
This product is licensed under the GroupDocs End User License Agreement (EULA). For pricing information, visit the [GroupDocs.Comparison for Node.js via Java pricing page](https://purchase.groupdocs.com/pricing/comparison/nodejs-java/).
|
|
185
|
+
|
|
186
|
+
## Support
|
|
187
|
+
|
|
188
|
+
GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/), [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) and [Paid Consulting](https://consulting.groupdocs.com/).
|
|
189
|
+
|
|
190
|
+
### Free Support Forum
|
|
191
|
+
|
|
192
|
+
The [GroupDocs Free Support Forum](https://forum.groupdocs.com/) is available to all users and provides:
|
|
193
|
+
- Direct access to the GroupDocs.Total development team
|
|
194
|
+
- Community-driven support and knowledge sharing
|
|
195
|
+
- No time limitations on support requests
|
|
196
|
+
- Access to historical solutions and discussions
|
|
197
|
+
|
|
198
|
+
### Paid Support Helpdesk
|
|
199
|
+
|
|
200
|
+
The [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) offers:
|
|
201
|
+
- Higher priority response times
|
|
202
|
+
- Dedicated support team
|
|
203
|
+
- Extended support hours
|
|
204
|
+
- Priority issue resolution
|
|
205
|
+
|
|
206
|
+
### Paid Consulting
|
|
207
|
+
|
|
208
|
+
We can work together with you on your project and develop a part or complete application. If you need new features in the existing GroupDocs product or to create API for new file formats, send us a request at [consulting.groupdocs.com/contact](https://consulting.groupdocs.com/contact/).
|
|
209
|
+
|
|
210
|
+
---
|
|
51
211
|
|
|
52
|
-
[Home](https://www.groupdocs.com/) | [Product
|
|
212
|
+
[Home](https://www.groupdocs.com/) | [Product Home](https://products.groupdocs.com/comparison/nodejs-java/) | [Documentation](https://docs.groupdocs.com/comparison/nodejs-java/) | [Blog](https://blog.groupdocs.com/categories/groupdocs.comparison-product-family/) | [Code Samples](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-Node.js-via-Java) | [Free Support](https://forum.groupdocs.com/c/comparison/12) | [Temporary License](https://purchase.groupdocs.com/temporary-license) | [Pricing](https://purchase.groupdocs.com/pricing/comparison/nodejs-java/)
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@groupdocs/groupdocs.comparison",
|
|
3
|
-
"version": "25.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "25.11.0",
|
|
4
|
+
"description": "Document comparison API to diff PDF, DOCX, XLSX, PPTX and other the most popular document formats using JavaScript.",
|
|
5
5
|
"scripts": {
|
|
6
6
|
"postinstall": "curl -H 'Cache-Control:no-cache' https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-comparison-nodejs/25.6/groupdocs-comparison-nodejs-25.6.jar --ssl-no-revoke > lib/groupdocs-comparison-nodejs-25.6.jar"
|
|
7
7
|
},
|
|
@@ -29,7 +29,7 @@
|
|
|
29
29
|
"author": "Aspose",
|
|
30
30
|
"license": "End User License Agreement.html",
|
|
31
31
|
"dependencies": {
|
|
32
|
-
"java": "^0.
|
|
32
|
+
"java": "^0.18.0"
|
|
33
33
|
},
|
|
34
34
|
"directories": {
|
|
35
35
|
"lib": "lib"
|