Merge pull request #930 from dynamsoft-docs/preview

Ellie-dynamsoft · web-flow · commit 5739cbf758fc · 2025-10-13T16:59:17.000+08:00
update to internal commit e40f1fa4
diff --git a/_articles/hello-world/editing.md b/_articles/hello-world/editing.md
@@ -124,19 +124,19 @@ APIs used:
                         Dynamsoft.DWT.EnumDWT_ImageType.IT_PNG,
                         Dynamsoft.DWT.EnumDWT_UploadDataFormat.Binary,
                         "WebTWAINImage.png",
-                        onUploadSuccess,
-                        onUploadFailure
+                        onEmptyResponse,
+                        onServerReturnedSomething
                     );
                 } else {
                     alert("There is no image in buffer.");
                 }
             }
 
-            function onUploadSuccess() {
+            function onEmptyResponse() {
                 alert("Upload successful");
             }
 
-            function onUploadFailure(errorCode, errorString, sHttpResponse) {
+            function onServerReturnedSomething(errorCode, errorString, sHttpResponse) {
                 alert(sHttpResponse.length > 0 ? sHttpResponse : errorString);
             }
 
diff --git a/_articles/hello-world/scan-settings.md b/_articles/hello-world/scan-settings.md
@@ -90,19 +90,19 @@ function AcquireImage() {
                         Dynamsoft.DWT.EnumDWT_ImageType.IT_PNG,
                         Dynamsoft.DWT.EnumDWT_UploadDataFormat.Binary,
                         "WebTWAINImage.png",
-                        onUploadSuccess,
-                        onUploadFailure,
+                        onEmptyResponse,
+                        onServerReturnedSomething,
                     );
                 } else {
                     alert("There is no image in buffer.");
                 }
             }
 
-            function onUploadSuccess() {
+            function onEmptyResponse() {
                 alert("Upload successful");
             }
 
-            function onUploadFailure(errorCode, errorString, sHttpResponse) {
+            function onServerReturnedSomething(errorCode, errorString, sHttpResponse) {
                 alert(sHttpResponse.length > 0 ? sHttpResponse : errorString);
             }
         </script>
diff --git a/_articles/hello-world/uploading.md b/_articles/hello-world/uploading.md
@@ -39,19 +39,19 @@ function upload() {
             Dynamsoft.DWT.EnumDWT_ImageType.IT_PNG,
             Dynamsoft.DWT.EnumDWT_UploadDataFormat.Binary, 
             "WebTWAINImage.png", 
-            onUploadSuccess, 
-            onUploadFailure
+            onEmptyResponse, 
+            onServerReturnedSomething
         );
     } else {
         alert("There is no image in buffer.");
     }
 }
 
-function onUploadSuccess() {
+function onEmptyResponse() {
     alert('Upload successful');
 }
 
-function onUploadFailure(errorCode, errorString, sHttpResponse) {
+function onServerReturnedSomething(errorCode, errorString, sHttpResponse) {
     alert(sHttpResponse.length > 0 ? sHttpResponse : errorString);
 }
 ```
@@ -116,19 +116,19 @@ Following this guide, your `HelloWorld.html` should look similar to this:
                         Dynamsoft.DWT.EnumDWT_ImageType.IT_PNG,
                         Dynamsoft.DWT.EnumDWT_UploadDataFormat.Binary, 
                         "WebTWAINImage.png", 
-                        onUploadSuccess, 
-                        onUploadFailure
+                        onEmptyResponse, 
+                        onServerReturnedSomething
                     );
                 } else {
                     alert("There is no image in buffer.");
                 }
             }
 
-            function onUploadSuccess() {
+            function onEmptyResponse() {
                 alert('Upload successful');
             }
 
-            function onUploadFailure(errorCode, errorString, sHttpResponse) {
+            function onServerReturnedSomething(errorCode, errorString, sHttpResponse) {
                 alert(sHttpResponse.length > 0 ? sHttpResponse : errorString);
             }
         </script>
diff --git a/_articles/info/api/WebTwain_IO.md b/_articles/info/api/WebTwain_IO.md
@@ -1490,7 +1490,7 @@ HTTPUpload(
 
 `onEmptyResponse`: A callback function that is executed if the response is empty.
 
-`onServerReturnedSomething`: A callback function that is executed if the response is not empty.
+`onServerReturnedSomething`: A callback function that is executed if the response is not empty. The accepted response type is `string`.
 
 - `errorCode` The error code.
 - `errorString` The error string.
@@ -2070,6 +2070,10 @@ httpUploadBlob(
     - `name`: The name of header.
     - `value`: The value of header.
 
+**Return Values**
+
+A Promise object of the response that is resolved based on the `responseType` parameter.
+
 **Availability**
 
 <div class="availability">
diff --git a/assets/HelloWorld-Code.zip b/assets/HelloWorld-Code.zip

Original file line number	Diff line number	Diff line change
`@@ -124,19 +124,19 @@ APIs used:`
`124`	`124`	`Dynamsoft.DWT.EnumDWT_ImageType.IT_PNG,`
`125`	`125`	`Dynamsoft.DWT.EnumDWT_UploadDataFormat.Binary,`
`126`	`126`	`"WebTWAINImage.png",`
`127`		`- onUploadSuccess,`
`128`		`- onUploadFailure`
	`127`	`+ onEmptyResponse,`
	`128`	`+ onServerReturnedSomething`
`129`	`129`	`);`
`130`	`130`	`} else {`
`131`	`131`	`alert("There is no image in buffer.");`
`132`	`132`	`}`
`133`	`133`	`}`
`134`	`134`
`135`		`- function onUploadSuccess() {`
	`135`	`+ function onEmptyResponse() {`
`136`	`136`	`alert("Upload successful");`
`137`	`137`	`}`
`138`	`138`
`139`		`- function onUploadFailure(errorCode, errorString, sHttpResponse) {`
	`139`	`+ function onServerReturnedSomething(errorCode, errorString, sHttpResponse) {`
`140`	`140`	`alert(sHttpResponse.length > 0 ? sHttpResponse : errorString);`
`141`	`141`	`}`
`142`	`142`
Original file line number	Diff line number	Diff line change
`@@ -90,19 +90,19 @@ function AcquireImage() {`
`90`	`90`	`Dynamsoft.DWT.EnumDWT_ImageType.IT_PNG,`
`91`	`91`	`Dynamsoft.DWT.EnumDWT_UploadDataFormat.Binary,`
`92`	`92`	`"WebTWAINImage.png",`
`93`		`- onUploadSuccess,`
`94`		`- onUploadFailure,`
	`93`	`+ onEmptyResponse,`
	`94`	`+ onServerReturnedSomething,`
`95`	`95`	`);`
`96`	`96`	`} else {`
`97`	`97`	`alert("There is no image in buffer.");`
`98`	`98`	`}`
`99`	`99`	`}`
`100`	`100`
`101`		`- function onUploadSuccess() {`
	`101`	`+ function onEmptyResponse() {`
`102`	`102`	`alert("Upload successful");`
`103`	`103`	`}`
`104`	`104`
`105`		`- function onUploadFailure(errorCode, errorString, sHttpResponse) {`
	`105`	`+ function onServerReturnedSomething(errorCode, errorString, sHttpResponse) {`
`106`	`106`	`alert(sHttpResponse.length > 0 ? sHttpResponse : errorString);`
`107`	`107`	`}`
`108`	`108`	`</script>`
Original file line number	Diff line number	Diff line change
`@@ -39,19 +39,19 @@ function upload() {`
`39`	`39`	`Dynamsoft.DWT.EnumDWT_ImageType.IT_PNG,`
`40`	`40`	`Dynamsoft.DWT.EnumDWT_UploadDataFormat.Binary,`
`41`	`41`	`"WebTWAINImage.png",`
`42`		`- onUploadSuccess,`
`43`		`- onUploadFailure`
	`42`	`+ onEmptyResponse,`
	`43`	`+ onServerReturnedSomething`
`44`	`44`	`);`
`45`	`45`	`} else {`
`46`	`46`	`alert("There is no image in buffer.");`
`47`	`47`	`}`
`48`	`48`	`}`
`49`	`49`
`50`		`-function onUploadSuccess() {`
	`50`	`+function onEmptyResponse() {`
`51`	`51`	`alert('Upload successful');`
`52`	`52`	`}`
`53`	`53`
`54`		`-function onUploadFailure(errorCode, errorString, sHttpResponse) {`
	`54`	`+function onServerReturnedSomething(errorCode, errorString, sHttpResponse) {`
`55`	`55`	`alert(sHttpResponse.length > 0 ? sHttpResponse : errorString);`
`56`	`56`	`}`
`57`	`57`	```
@@ -116,19 +116,19 @@ Following this guide, your `HelloWorld.html` should look similar to this:
`116`	`116`	`Dynamsoft.DWT.EnumDWT_ImageType.IT_PNG,`
`117`	`117`	`Dynamsoft.DWT.EnumDWT_UploadDataFormat.Binary,`
`118`	`118`	`"WebTWAINImage.png",`
`119`		`- onUploadSuccess,`
`120`		`- onUploadFailure`
	`119`	`+ onEmptyResponse,`
	`120`	`+ onServerReturnedSomething`
`121`	`121`	`);`
`122`	`122`	`} else {`
`123`	`123`	`alert("There is no image in buffer.");`
`124`	`124`	`}`
`125`	`125`	`}`
`126`	`126`
`127`		`- function onUploadSuccess() {`
	`127`	`+ function onEmptyResponse() {`
`128`	`128`	`alert('Upload successful');`
`129`	`129`	`}`
`130`	`130`
`131`		`- function onUploadFailure(errorCode, errorString, sHttpResponse) {`
	`131`	`+ function onServerReturnedSomething(errorCode, errorString, sHttpResponse) {`
`132`	`132`	`alert(sHttpResponse.length > 0 ? sHttpResponse : errorString);`
`133`	`133`	`}`
`134`	`134`	`</script>`