aboutsummaryrefslogtreecommitdiff
path: root/files/ja/web/api/filereader/readasbinarystring/index.html
blob: 2c0899a89b24a5db8d3fcf6961c2b135fcb9d51f (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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
---
title: FileReader.readAsBinaryString()
slug: Web/API/FileReader/readAsBinaryString
tags:
  - API
  - File API
  - Files
  - Method
  - Reference
translation_of: Web/API/FileReader/readAsBinaryString
---
<p>{{APIRef("File API")}}</p>

<div class="hidden">
<p>{{event("loadend")}}は英語版では {{domxref("XMLHttpRequest/loadend_event", "loadend")}} にリダイレクトされますが、日本語版ではリダイレクト元ページが存在しない(作成も不可)ため、日本語版ではリダイレクト先を直接記述しています。</p>
</div>

<p><code>readAsBinaryString</code> メソッドは、 指定された {{domxref("Blob")}} ないし {{domxref("File")}} オブジェクトを読み込むために使用します。 読込処理が終了すると {{domxref("FileReader.readyState","readyState")}}<code>DONE</code> に変わり、{{domxref("XMLHttpRequest/loadend_event", "loadend")}} イベントが生じます。それと同時に {{domxref("FileReader.result","result")}} プロパティには生のバイナリデータを文字列で解釈したものが格納されます。</p>

<p>このメソッドは、File API の仕様から一度削除されましたが、後方互換のために再導入されました。<br>
 {{domxref("FileReader.readAsArrayBuffer()")}} の使用が推奨されています。</p>

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

<pre class="syntaxbox notranslate"><em>instanceOfFileReader</em>.readAsBinaryString(blob);</pre>

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

<dl>
 <dt><code>blob</code></dt>
 <dd>メソッドで読み込む {{domxref("Blob")}} または {{domxref("File")}} オブジェクトです。</dd>
</dl>

<h2 id="Example" name="Example"></h2>

<pre class="brush: js notranslate">var canvas = document.createElement('canvas');
var height = 200;
var width  = 200;

canvas.width  = width;
canvas.height = height;

var ctx = canvas.getContext('2d');

ctx.strokeStyle = '#090';
ctx.beginPath();
ctx.arc(width/2, height/2, width/2 - width/10, 0, Math.PI*2);
ctx.stroke();

canvas.toBlob(function (blob) {
  var reader = new FileReader();

  reader.onload = function () {
    console.log(reader.result);
  }

  reader.readAsBinaryString(blob);
});</pre>

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

<table class="spectable standard-table">
 <thead>
  <tr>
   <th scope="col">仕様</th>
   <th scope="col">ステータス</th>
   <th scope="col">コメント</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('File API','#readAsBinaryString','readAsBinaryString')}}</td>
   <td>{{Spec2('File API')}}</td>
   <td></td>
  </tr>
 </tbody>
</table>

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

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

<p>{{Compat("api.FileReader.readAsBinaryString")}}</p>

<h2 id="See_also" name="See also">関連情報</h2>

<ul>
 <li>{{domxref("FileReader")}}</li>
</ul>