mozilla
您的搜索结果

    Blob

    一个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 long Blob对象中所包含数据的大小. 只读.
    type DOMString 一个字符串,表明该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上.
    

    浏览器兼容性

    Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
    Basic support 5 4 10 11.10 5.1
    slice()

    21
    10 webkit

    13
    5 moz
    10 12 5.1 (534.29) webkit
    Blob() constructor 20 13.0 (13.0) 10 12.10 6 (536.10)
    Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
    Basic support ? 13.0 (13.0) ? ? ?

    注意:关于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位无符号数字范围,现已修复.

    相关链接

    文档标签和贡献者

    此页面的贡献者有: ziyunfei
    最后编辑者: ziyunfei,