aboutsummaryrefslogtreecommitdiff
path: root/files/zh-cn/web/api/blob/slice/index.html
blob: c0d7ccfa9b78160cfac02232a8339cfca2fcfb9d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
---
title: Blob.slice
slug: Web/API/Blob/slice
translation_of: Web/API/Blob/slice
---
<p>{{APIRef("File API")}}</p>

<p><strong><code>Blob.slice() </code></strong>方法用于创建一个包含源 {{domxref("Blob")}}的指定字节范围内的数据的新 {{domxref("Blob")}} 对象。</p>

<div class="note"><strong>注释:</strong> 请注意, 在某些浏览器和版本上具有供应商前缀:例如:Firefox 12及更早版本的blob.mozSlice() 和 Safari中的 blob.webkitSlice(). slice() 方法的旧版本,没有供应商前缀,具有不同的语义,并且已过时。</div>

<h2 id="语法">语法</h2>

<pre>var blob = instanceOfBlob.slice([start [, end [, contentType]]]};</pre>

<h3 id="参数">参数</h3>

<dl>
 <dt><code>start</code> {{ optional_inline() }}</dt>
 <dd>这个参数代表 {{domxref("Blob")}} 里的下标,表示第一个会被会被拷贝进新的 {{domxref("Blob")}} 的字节的起始位置。如果你传入的是一个负数,那么这个偏移量将会从数据的末尾从后到前开始计算。举例来说, -10 将会是  {{domxref("Blob")}} 的倒数第十个字节。它的默认值是0, 如果你传入的<span style="font-family: 'Courier New','Andale Mono',monospace; line-height: normal;">start的长度大于源 </span><span style="line-height: 1.5;">{{domxref("Blob")}} 的长度,那么返回的</span><span style="line-height: 1.5;">将会是一个长度为0并且不包含任何数据的一个 </span><span style="line-height: 1.5;">{{domxref("Blob")}} 对象。</span></dd>
 <dt><code>end</code> {{ optional_inline() }}</dt>
 <dd>这个参数代表的是 {{domxref("Blob")}} 的一个下标,这个下标-1的对应的字节将会是被拷贝进新的{{domxref("Blob")}} 的最后一个字节。如果你传入了一个负数,那么这个偏移量将会从数据的末尾从后到前开始计算。举例来说, -10 将会是 {{domxref("Blob")}} 的倒数第十个字节。它的默认值就是它的原始长度(<code>size</code>).</dd>
 <dt><code>contentType</code> {{ optional_inline() }}</dt>
 <dd>给新的 {{domxref("Blob")}} 赋予一个新的文档类型。这将会把它的 <span style="font-family: 'Courier New','Andale Mono',monospace; line-height: normal;">type 属性设为被传入的值。它的默认值是一个空的字符串。</span></dd>
</dl>

<h3 id="返回值">返回值</h3>

<p>一个新的 {{domxref("Blob")}} 对象,它包含了原始 {{domxref("Blob")}} 对象的某一个段的数据。</p>

<h2 id="Browser_Compatibility" name="Browser_Compatibility">规范</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">规范</th>
   <th scope="col">状态</th>
   <th scope="col">注释</th>
  </tr>
  <tr>
   <td>{{SpecName('File API','#dfn-slice','slice')}}</td>
   <td>{{Spec2('File API')}}</td>
   <td>Initial definition.</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility" name="Browser_compatibility">浏览器兼容</h2>

{{Compat("api.Blob.slice")}}

<h2 id="参见">参见</h2>

<ul>
 <li>{{domxref("Blob")}}</li>
 <li>{{domxref("BlobBuilder")}}</li>
</ul>