mozilla

Compare Revisions

Blob

Change Revisions

Revision 474851:

Revision 474851 by Jeremie on

Revision 474883:

Revision 474883 by Jeremie on

Title:
Blob
Blob
Slug:
Web/API/Blob
Web/API/Blob
Tags:
"Files", "API", "Interface"
"Files", "API", "Reference", "WebAPI"
Content:

Revision 474851
Revision 474883
n19    <div class="note">n
20      <strong>Note:</strong> Be aware that the <code>slice()</cod
>e> method has vendor prefixes on some browsers and versions: <cod 
>e>blob.mozSlice()</code> for Firefox 12 and earlier and <code>blo 
>b.webkitSlice()</code> in Safari. An old version of the <code>sli 
>ce()</code> method, without vendor prefixes, had different semant 
>ics, and is obsolete. 
21    </div>
22    <div class="note">
23      <strong>Note:</strong> Some browsers offer {{ domxref("Blob
>Builder") }}, which lets you iteratively append data to a blob, t 
>hen retrieve the completed blob when you're ready to use it for s 
>omething. However, <code>BlobBuilder</code> is not available in e 
>very browsers and all <code>BlobBuilder</code> implementations ha 
>ve vendor prefixes. And it is deprecated in favor of the <code>Bl 
>ob</code> constructor. You should use <code>Blob</code> construct 
>or whenever possible. 
24    </div>
nn65    <div class="note">
66      <strong>Note:</strong> Some browsers offer {{ domxref("Blob
 >Builder") }}, which lets you iteratively append data to a blob, t
 >hen retrieve the completed blob when you're ready to use it for s
 >omething. However, <code>BlobBuilder</code> is not available in e
 >very browsers and all <code>BlobBuilder</code> implementations ha
 >ve vendor prefixes. And it is deprecated in favor of the <code>Bl
 >ob</code> constructor. You should use <code>Blob</code> construct
 >or whenever possible.
67    </div>
n93        {{domxref("Blob.slice()"}}n90        {{domxref("Blob.slice()")}}
n99    <h3 id="slice()">n96    <div class="note">
100      slice()97      <strong>Note:</strong> Be aware that the <code>slice()</cod
 >e> method has vendor prefixes on some browsers and versions: <cod
 >e>blob.mozSlice()</code> for Firefox 12 and earlier and <code>blo
 >b.webkitSlice()</code> in Safari. An old version of the <code>sli
 >ce()</code> method, without vendor prefixes, had different semant
 >ics, and is obsolete.
101    </h3>
102    <p>
103      Returns a new <code>Blob</code> object containing the data 
>in the specified range of bytes of the source <code>Blob</code>. 
104    </p>
105    <pre>
106Blob slice(
107  optional long long start,
108  optional long long end,
109  optional DOMString contentType
110};
111</pre>
112    <h4 id="Parameters">
113      Parameters
114    </h4>
115    <dl>
116      <dt>
117        <code>start</code> {{ optional_inline() }}
118      </dt>
119      <dd>
120        An index into the <code>Blob</code> indicating the first 
>byte to copy into the new <code>Blob</code>. If you specify a neg 
>ative value, it's treated as an offset from the end of the string 
> toward the beginning. For example, -10 would be the 10th from la 
>st byte in the <code>Blob</code>. The default value is 0. 
121      </dd>
122      <dt>
123        <code>end</code> {{ optional_inline() }}
124      </dt>
125      <dd>
126        An index into the <code>Blob</code> indicating the last b
>yte to copy into the new <code>Blob</code>. If you specify a nega 
>tive value, it's treated as an offset from the end of the string  
>toward the beginning. For example, -10 would be the 10th from las 
>t byte in the <code>Blob</code>. The default value is <code>size< 
>/code>. 
127      </dd>
128      <dt>
129        <code>contentType</code> {{ optional_inline() }}
130      </dt>
131      <dd>
132        The content type to assign to the new <code>Blob</code>; 
>this will be the value of its <code>type</code> property. The def 
>ault value is an empty string. 
133      </dd>
134    </dl>98    </div>
135    <h4 id="Return_value">99    <h2 id="Examples">
136      Return value
137    </h4>
138    <p>
139      A new <code>Blob</code> object containing the specified dat
>a from the source <code>Blob</code>. 
140    </p>
141    <h4 id="Notes">
142      Notes
143    </h4>
144    <p>
145      If you specify a value for <code>start</code> that is large
>r than the size of the source <code>Blob</code>, the returned <co 
>de>Blob</code> has size 0 and contains no data. 
146    </p>
147    <h2>
n394      <li>{{ spec("http://www.w3.org/TR/FileAPI/#dfn-Blob", "Filen
> API&nbsp;Specification:&nbsp;Blob", "WD") }} 
395      </li>
396      <li>{{ spec("http://dev.w3.org/2006/webapi/FileAPI/#dfn-Blo
>b", "File API Specification: Blob", "ED") }} 
397      </li>
n402      <li>n
403        <a href="/en-US/docs/Web/API/FileReader" style="line-heig
>ht: 22px;" title="/en-US/docs/Web/API/FileReader">FileReader</a> 
404      </li>
405      <li>{{ domxref("XMLHttpRequest/FormData", "FormData") }}
406      </li>
t408    <p>t
409      {{ languages( { "en": "en/DOM/Blob", "ja": "ja/DOM/Blob" } 
>) }} 
410    </p>

Back to History