Blob DOM JS

来源:互联网 发布:同步助手java 编辑:程序博客网 时间:2024/06/08 10:58

Blob


TABLE OF CONTENTS

  1. 属性
  2. 构造函数
  3. 方法
    1. slice()
      1. 参数
      2. 返回值
      3. 注意
  4. BlobPropertyBag
  5. Blob构造函数用法举例
  6. 例子:使用类型数组和Blob对象创建一个对象URL
  7. 浏览器兼容性
    1. 注意:关于slice()的实现
    2. Gecko备注
  8. 相关链接
  • TAGS 
  • 文件

一个Blob对象就是一个包含有只读原始数据的类文件对象.Blob对象中的数据并不一定得是JavaScript中的原生形式.File接口基于Blob,继承了Blob的功能,并且扩展支持了用户计算机上的本地文件.

创建Blob对象的方法有几种,可以调用Blob构造函数,还可以使用一个已有Blob对象上的slice()方法切出另一个Blob对象,还可以调用canvas对象上的toBlob方法.

注: 需要注意的是,一些浏览器上的slice()方法仍带有前缀:Firefox 12之前的版本上为blob.mozSlice(),Safari上为blob.webkitSlice().
注: 一些浏览器提供了BlobBuilder接口,但并不是所有的浏览器都支持BlobBuilder,而且现有的BlobBuilder实现都是带前缀的.更主要的是BlobBuilder已经被废弃,你应该尽可能的使用Blob构造函数来代替.

属性

属性名    类型描述size       unsigned long longBlob对象中所包含数据的大小只读.typeDOMString一个字符串,表明该Blob对象所包含数据的MIME类型.如果类型未知,则该值为空字符串. 只读.

构造函数

Blob Blob(  [optional] Array parts,  [optional] BlobPropertyBag properties);
参数
parts
一个数组,包含了将要添加到Blob对象中的数据.数组元素可以是任意多个的ArrayBuffer,ArrayBufferView (typed array), Blob,或者 DOMString对象.
properties
一个对象,设置Blob对象的一些属性.查看BlobPropertyBag一节.

方法

slice()

返回一个新的Blob对象,包含了源Blob对象中指定范围内的数据.

Blob slice(  optional long long start,  optional long long end,  optional DOMString contentType};

参数

start 可选
开始索引,可以为负数,语法类似于数组的slice方法.默认值为0.
end 可选
结束索引,可以为负数,语法类似于数组的slice方法.默认值为最后一个索引.
contentType 可选
新的Blob对象的MIME类型,这个值将会成为新的Blob对象的type属性的值,默认为一个空字符串.

返回值

一个新的Blob对象,包含了源Blob对象中指定范围内的数据.

注意

如果start参数的值比源Blob对象的size属性的值还大,则返回的Blob对象的size值为0,也就是不包含任何数据.

BlobPropertyBag

一个包含有两个属性typeendings的对象.

type
设置该Blob对象的type属性.
endings(已废弃)
对应于BlobBuilder.append()方法的endings参数.该参数的值可以是"transparent"或者"native".

Blob构造函数用法举例

下面的代码:

var aFileParts = ["<a id=\"a\"><b id=\"b\">hey!<\/b><\/a>"];var oMyBlob = new Blob(aFileParts, { "type" : "text\/xml" }); // the blob

等价于:

var oBuilder = new BlobBuilder();var aFileParts = ["<a id=\"a\"><b id=\"b\">hey!<\/b><\/a>"];oBuilder.append(aFileParts[0]);var oMyBlob = oBuilder.getBlob("text\/xml"); // the blob

BlobBuilder接口提供了另外一种创建Blob对象的方式,但该方式现在已经废弃,所以不应该再使用了.

例子:使用类型数组和Blob对象创建一个对象URL

var typedArray = GetTheTypedArraySomehow();var blob = new Blob([typedArray], {type: "application/octet-binary"}); // 传入一个合适的MIME类型var url = URL.createObjectURL(blob);// 会产生一个类似blob:d3958f5c-0777-0845-9dcf-2cb28783acaf这样的URL字符串// 你可以像使用一个普通URL那样使用它,比如用在img.src上.

浏览器兼容性

  • Desktop 
  • Mobile
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)Basic support541011.105.1slice()

21
10 webkit

13
moz‡10125.1 (534.29) webkitBlob() constructor2013.0 (13.0)1012.106 (536.10)

注意:关于slice()的实现

slice()方法一开始使用length来作为第二个参数,表示需要向新的Blob对象拷贝多少个字节.如果你指定的参数值start + length的值超过了源Blob对象的长度,则返回的Blob对象包含了从start索引到源Blob对象结束索引处的所有数据.

这个版本的slice()实现于Firefox 4, WebKit,以及 Opera 11.10中.可是,由于这个语法和我们常用的Array.slice()以及String.slice()语法不同,所以已被废弃.Gecko和WebKit目前支持的是新版的slice语法.

从Gecko 13.0 (Firefox 13.0 / Thunderbird 13.0 / SeaMonkey 2.10)和Chrome 21开始,slice()去掉了前缀.‡

Gecko备注

在Gecko 12.0 (Firefox 12.0 / Thunderbird 12.0 / SeaMonkey 2.9)之前,slice()方法有个bug,就是参数startend的值不能超出64位无符号数字范围,现已修复.

相关链接

  • File API Specification: BlobWD
  • File API Specification: BlobED
  • BlobBuilder
  • File
  • FormData