From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/zh-cn/web/api/formdata/set/index.html | 152 ++++++++++++++++++++++++++++ 1 file changed, 152 insertions(+) create mode 100644 files/zh-cn/web/api/formdata/set/index.html (limited to 'files/zh-cn/web/api/formdata/set') diff --git a/files/zh-cn/web/api/formdata/set/index.html b/files/zh-cn/web/api/formdata/set/index.html new file mode 100644 index 0000000000..e07fc46185 --- /dev/null +++ b/files/zh-cn/web/api/formdata/set/index.html @@ -0,0 +1,152 @@ +--- +title: FormData.set() +slug: Web/API/FormData/set +translation_of: Web/API/FormData/set +--- +

{{APIRef("XMLHttpRequest")}}

+ +

set() 方法会对 FormData 对象里的某个 key 设置一个新的值，如果该 key 不存在，则添加。

+ +

set() 和 {{domxref("FormData.append")}} 不同之处在于：如果某个 key 已经存在，set() 会直接覆盖所有该 key 对应的值，而 {{domxref("FormData.append")}} 则是在该 key 的最后位置再追加一个值。

+ +
+

注意: 该方法在 Web Workers 可用。

+
+ +

语法

+ +

该方法有两种使用方式，一个是传入两个参数，一个是传入三个参数。

+ +
formData.set(name, value);
+formData.set(name, value, filename);
+ +

参数

+ +
+
name
+
字段名称。
+
value
+
字段的值，如果是传入两个参数的方式，那么该值是一个 {{domxref("USVString")}}，如果不是，将被转成一个字符串。如果是传入三个参数的方式，那么该值将是一个布尔值（{{domxref("Blob")}}），文件（{{domxref("File")}}），或者一个 {{domxref("USVString")}}，如果不是，将被转成一个字符串。
+
filename {{optional_inline}}
+
当第二个参数传递的是一个blob对象（{{domxref("Blob")}}）或者file对象（{{domxref("File")}}），filename参数就代表传给服务端的文件名（一个{{domxref("USVString")}}）。{{domxref("Blob")}} 对象的默认文件名是 "blob"。
+
+ +
+

注意: 如果对 FormData 对象插入一个blob对象（ {{domxref("Blob")}}），那么发送给服务器的请求头部（header） 里的 “Content-Disposition” 里的文件名称将会根据浏览器的不同而不同。

+
+ +

示例

+ +

先创建一个空的 FormData 对象：

+ +
var formData = new FormData(); // Currently empty
+ +

使用 {{domxref("FormData.set")}} 设置键/值 ：

+ +
formData.set('username', 'Chris');
+formData.set('userpic', myFileInput.files[0], 'chris.jpg');
+ +

规范

+ + + + + + + + + + + + + + +
规范状态说明
{{SpecName('XMLHttpRequest','#dom-formdata-set','set()')}}{{Spec2('XMLHttpRequest')}} 
+ +

浏览器兼容性

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{CompatChrome(50.0)}}{{CompatGeckoDesktop("39.0")}}{{CompatNo}}{{CompatNo}}{{CompatNo}}
Available in web workers{{CompatChrome(50.0)}}{{CompatGeckoDesktop("39.0")}}{{CompatNo}}{{CompatNo}}{{CompatNo}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidAndroid WebviewFirefox Mobile (Gecko)Firefox OS (Gecko)IE MobileOpera MobileSafari MobileChrome for Android
Basic support{{CompatNo}}{{CompatChrome(50.0)}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatNo}} +

{{CompatNo}}

+ 		{{CompatNo}}{{CompatChrome(50.0)}}
Available in web workers{{CompatNo}}{{CompatChrome(50.0)}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatNo}}{{CompatNo}}{{CompatNo}}{{CompatChrome(50.0)}}
+
+ +

 

+ +

相关链接

+ + -- cgit v1.2.3-54-g00ecf