このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

FileSystemEntry: toURL() メソッド

Deprecated

Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.

非標準: この機能は標準化されていません。非標準の機能はブラウザーの対応が限られ、将来的に変更または削除される可能性があるため、本番環境での使用は推奨されません。ただし、標準の選択肢が存在しない特定のケースでは、有効な代替手段となる場合があります。

FileSystemEntry インターフェイスの toURL() メソッドは、ファイルシステム項目を識別するために使用することができる URL を格納した文字列を作成して返します。 これは src 属性や href 属性の値として使用することができる新しい URL スキーム filesystem: を公開することで行われます。

構文

js
toURL()
toURL(mimeType)

引数

mimeType 省略可

オプションの文字列で、ファイルを解釈するときに使用する MIME タイプを指定します。これは、ユーザーエージェントが自動的に認識しない型を持つファイルに対処するために使用することができます。この引数が省略された場合、ユーザーエージェントは標準アルゴリズムを使用してファイルを識別します。

返値

HTML コンテンツ内の文書参照として使用することができる URL を含む文字列、または URL を生成できない場合は空文字列(ファイルシステムの実装が toURL() をサポートしていない場合など)。

ウェブサイトやアプリで利用できるファイルシステムに画像ファイルに対応する FileSystemFileEntry がある場合、toURL() を呼び出すと HTML の中で使用することができます。自分のサイトが http://my-awesome-website.woot にあり、一時ファイルシステムに awesomesauce.jpg という名前の画像ファイルがある場合、toURL() が返す URL は(ブラウザー実装によっては)"filesystem:http://my-awesome-website.woot/temporary/awesomesauce.jpg" のようなものになるかもしれません。

これを使用するコードは次のようになるでしょう。

js
let img = document.createElement("img");

img.src = imageFileEntry.toURL();
document.body.appendChild(img);

コードの前に述べたシナリオを想定すると、結果は次のような HTML が文書の終わりに追加されることになります。

html
<img
  src="filesystem:http://my-awesome-website.woot/temporary/awesomesauce.jpg" />

ブラウザーの互換性

関連情報