メインコンテンツへ飛ぶ

webUtils

Web API オブジェクト (File、Blob など) とやり取りするためのユーティリティ層

プロセス: レンダラー

info

コンテキスト分離が有効になっているレンダラープロセスからこの API を呼び出す場合は、プリロードスクリプトに API 呼び出しを記述し​​、contextBridge API を使用して 公開 してください。

メソッド

webUtils モジュールには以下のメソッドがあります。

webUtils.getPathForFile(file)

  • file File - ウェブの File オブジェクト。

戻り値 string - この File オブジェクトが指すファイルシステムのパス。 渡されたオブジェクトが File オブジェクトでない場合、例外が送出されます。 渡された File オブジェクトが JS 内で構築され、ディスク上のファイルに由来しない場合、空の文字列が返されます。

このメソッドは、以前の path プロパティを付けた File オブジェクト拡張の置き換えとして用意されました。 以下にサンプルを示します。

// Before (renderer)
const oldPath = document.querySelector('input[type=file]').files[0].path
// その後

// レンダラー:

const file = document.querySelector('input[type=file]').files[0]
electronApi.doSomethingWithFile(file)

// プリロードスクリプト:

const { contextBridge, webUtils } = require('electron')

contextBridge.exposeInMainWorld('electronApi', {
doSomethingWithFile (file) {
const path = webUtils.getPathForFile(file)
// パスに対して、IPC 経由でメインプロセスへ送信するなど何らかの処理を実行します。
// できる限りウェブコンテンツへファイルのフルパスを公開しないことがベストです。
}
})