Skip to content

Commit 67e8b9c

Browse files
Ellie-dynamsoftEllie-dynamsoft
authored
Merge pull request #970 from dynamsoft-docs/preview
merge from preview
2 parents 1698125 + 53c8bc6 commit 67e8b9c

7 files changed

Lines changed: 83 additions & 12 deletions

File tree

‎_articles/extended-usage/ocr.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ It will copy an `ocr` folder to Dynamic Web TWAIN Service's [installation folder
4242

4343
### Step Two - Write a Basic Document Scanning Page
4444

45-
Create a HTML file with the following content. It can scan documents from scanners as well as loading local images.
45+
Create an HTML file with the following content. It can scan documents from scanners as well as loading local images.
4646

4747
```html
4848
<!DOCTYPE html>

‎_articles/faq/index.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -209,6 +209,7 @@ description: Dynamic Web TWAIN SDK Documentation FAQ
209209
32. [Why am I unable to load the TIFF file into Dynamic Web TWAIN?](/_articles/faq/unable-to-load-4-bit-tiff.md)
210210
33. [Error message - CORS Errors caused by local network access permissions when using Chromium 142 and later](/_articles/faq/chromium-142-local-network-access-issue.md)
211211
34. [Error message - File is Damaged and Can’t Be Opened in macOS](/_articles/faq/file-damaged-on-macos.md)
212+
35. [Safari 26.2 Regression Causing Dynamic Web TWAIN v19.3 Auto-Reconnect Failure on macOS](/_articles/faq/safari-26-2-regression.md)
212213

213214
## Licensing and Purchase
214215

‎_articles/faq/safari-26-2-regression.md‎

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
---
2+
layout: default-layout
3+
noTitleIndex: true
4+
needAutoGenerateSidebar: true
5+
title: Safari 26.2 Regression Causing Dynamic Web TWAIN v19.3 Auto-Reconnect Failure on macOS
6+
keywords: Dynamic Web TWAIN, macos, Auto-Reconnect, 19.3, Safari
7+
breadcrumbText: Safari 26.2 Regression Causing Dynamic Web TWAIN v19.3 Auto-Reconnect Failure on macOS
8+
description: Safari 26.2 Regression Causing Dynamic Web TWAIN v19.3 Auto-Reconnect Failure on macOS
9+
date: 2025-12-31 13:18:47 +0800
10+
last_modified: 2025-12-31 13:18:47 +0800
11+
---
12+
13+
# Safari 26.2 Regression Causing Dynamic Web TWAIN v19.3 Auto-Reconnect Failure on macOS
14+
15+
### Symptom
16+
17+
After upgrading to Safari 26.2 on macOS, a compatibility issue was observed with Dynamic Web TWAIN v19.3.
18+
19+
When a site installs or updates the Dynamic Web TWAIN v19.3 Service for the first time, the automatic connection and reconnect mechanism fails. A browser refresh is required to restore normal behavior.
20+
21+
### Issue characteristics
22+
23+
- Only occurs in Safari 26.2
24+
- Does not occur in Safari 26.1 or earlier versions
25+
- Does not occur in Dynamic Web TWAIN versions prior to 19.3
26+
27+
### Reason
28+
29+
Dynamic Web TWAIN 19.3 introduced a new configuration in reconnect requests: `targetAddressSpace: "loopback"`, following the Chrome Local Network Access documentation to explicitly indicate that the request targets the loopback address (127.0.0.1).
30+
31+
In Safari 26.1 and earlier, this configuration is ignored and requests are sent normally.
32+
33+
In Safari 26.2, `fetch` throws a `TypeError` when this configuration is present, causing the request to fail before being sent. As a result, `reconnect` cannot be implemented even though the Dynamsoft Service is installed and running.
34+
35+
### Update
36+
37+
The WebKit team has identified this issue as a regression in Safari 26.2 and has already fixed it. The fix will be included in an upcoming Safari release.

‎_articles/info/api/restful.md‎

Lines changed: 6 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1519,23 +1519,19 @@ const url = new URL("https://127.0.0.1:18623/api");
15191519
const documentuid = `190807444d76`;
15201520
const pathSegments = ['storage', 'documents', documentuid];
15211521
url.pathname = `${url.pathname}/${pathSegments.join('/')}`;
1522-
1522+
url.searchParams.set('pages', '190817548d70,190817648270');
1523+
url.searchParams.set('password', 'myFilePassword');
1524+
url.searchParams.set('quality', '50');
1525+
15231526
let myHeaders = new Headers();
15241527
myHeaders.append("DWT-DOC-PASSWORD", "myPassword");
1525-
1526-
let raw = JSON.stringify({
1527-
pages: '190817548d70,190817648270',
1528-
password: 'myFilePassword',
1529-
quality: 50
1530-
});
1531-
1528+
15321529
let requestOptions = {
15331530
method: 'GET',
15341531
headers: myHeaders,
1535-
body: raw,
15361532
redirect: 'follow'
15371533
};
1538-
1534+
15391535
fetch(url, requestOptions)
15401536
.then(response => response.text())
15411537
.then(result => console.log(result))

‎_articles/info/schedule/Stable.md‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -137,6 +137,10 @@ Updated the names of headers for the REST API.
137137
- Fixed a CORS request blocked error which also triggers a prompt to install the Dynamic Web TWAIN Service.
138138
- Fixed Vite runtime errors caused by polyfills and resource path misconfiguration.
139139

140+
## 18.5.3 (01/14/2026)
141+
142+
Updated third-party libraries to enhance security.
143+
140144
## 18.5.1 (10/22/2024)
141145

142146
### Improvements
@@ -1852,4 +1856,4 @@ In v10.0.1 there is no limit to the size of an Http Request. In v10.0, the WebSo
18521856

18531857
* TWAIN specification 1.9 compatible.
18541858
* Supports Native image transfer mode.
1855-
* Supports uploading and downloading image trough FTP.
1859+
* Supports uploading and downloading image through FTP.

‎api.json‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
---
2+
layout: null
3+
sitemap: false
4+
---
5+
{
6+
"articles": [
7+
{% assign filtered_articles = site.articles | where_exp: "article", "article.url contains '/info/api/'" %}
8+
{% for article in filtered_articles %}
9+
{
10+
"title": {{ article.title | jsonify }},
11+
"url": "https://www.dynamsoft.com{{ article.url | relative_url }}",
12+
"content": {{ article.content | strip_html | jsonify }},
13+
"breadcrumb": {{ article.breadcrumbText | default: article.title | jsonify }}
14+
}{% unless forloop.last %},{% endunless %}
15+
{% endfor %}
16+
]
17+
}

‎articles.json‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
---
2+
layout: null
3+
sitemap: false
4+
---
5+
{
6+
"articles": [
7+
{% for article in site.articles %}
8+
{
9+
"title": {{ article.title | jsonify }},
10+
"url": "https://www.dynamsoft.com{{ article.url | relative_url }}",
11+
"content": {{ article.content | strip_html | jsonify }},
12+
"breadcrumb": {{ article.breadcrumbText | default: article.title | jsonify }}
13+
}{% unless forloop.last %},{% endunless %}
14+
{% endfor %}
15+
]
16+
}

0 commit comments

Comments
 (0)