aboutsummaryrefslogtreecommitdiff
path: root/files/ja/web/api/blob/slice/index.html
blob: a724c23924463a3d126e8315ebaf0eba590e2121 (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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
---
title: Blob.slice()
slug: Web/API/Blob/slice
tags:
  - API
  - Blob
  - File
  - File API
  - Method
  - Reference
  - Section
  - Subset
  - data
  - slice
  - split
translation_of: Web/API/Blob/slice
---
<div>{{APIRef("File API")}}</div>

<p>{{domxref("Blob")}} インターフェイスの <strong><code>slice()</code></strong> メソッドは、呼び出された blob のサブセットのデータを含む新しい <code>Blob</code> オブジェクトを作成して返します。</p>

<h2 id="構文">構文</h2>

<pre class="syntaxbox notranslate">var <em>newBlob</em> = <em>blob</em>.slice(<em>start</em>, <em>end</em>, <em>contentType</em>);</pre>

<h3 id="パラメータ">パラメータ</h3>

<dl>
 <dt><code>start</code> {{optional_inline}}</dt>
 <dd>新しい {{domxref("Blob")}} に含める最初のバイトを示す {{domxref("Blob")}} へのインデックス。負の値を指定すると、{{domxref("Blob")}} の末尾から先頭へのオフセットとして扱われます。例えば、-10 は {{domxref("Blob")}} の最後のバイトから10番目になります。デフォルト値は 0 です。<code>start</code> にもとの {{domxref("Blob")}} のサイズよりも大きい値を指定すると、返される {{domxref("Blob")}} のサイズは 0 で、データは何も含まれません。</dd>
 <dt><code>end</code> {{optional_inline}}</dt>
 <dd>新しい {{domxref("Blob")}}<strong>含まれない</strong>最初のバイトを示す {{domxref("Blob")}} へのインデックス。(つまり、このインデックスに正確に位置するバイトは含まれません)。負の値を指定すると、{{domxref("Blob")}} の末尾から先頭へのオフセットとして扱われます。例えば、-10は {{domxref("Blob")}} の最後のバイトから10番目になります。デフォルト値は <code>size</code> です。</dd>
 <dt><code>contentType</code> {{optional_inline}}</dt>
 <dd>新しい {{domxref("Blob")}} に割り当てるコンテンツの型。これはその <code>type</code> プロパティの値になります。デフォルト値は空の文字列です。</dd>
</dl>

<h3 id="戻り値">戻り値</h3>

<p>このメソッドが呼び出された Blob 内に含まれるデータの指定されたサブセットを含む新しい {{domxref("Blob")}} オブジェクト。元の Blob は変更されません。</p>

<h2 id="仕様">仕様</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th>仕様</th>
   <th>ステータス</th>
   <th>コメント</th>
  </tr>
  <tr>
   <td>{{SpecName("File API", "#dfn-slice", "Blob.slice()")}}</td>
   <td>{{Spec2("File API")}}</td>
   <td>初期定義。</td>
  </tr>
 </tbody>
</table>

<h2 id="ブラウザの実装状況">ブラウザの実装状況</h2>

<div class="hidden">このページの互換性一覧表は、構造化データから生成されています。データに貢献したい方は、https://github.com/mdn/browser-compat-data をチェックしてプルリクエストを送ってください。</div>

<p>{{Compat("api.Blob.slice")}}</p>

<h2 id="あわせて参照">あわせて参照</h2>

<ul>
 <li>{{domxref("Blob")}}</li>
 <li>
  <p><a href="/ja/docs/Web/API/File/Using_files_from_web_applications">Web アプリケーションからのファイルの使用</a></p>
 </li>
</ul>