fbc5ff26e2Co-authored-by: trop[bot] <37223003+trop[bot]@users.noreply.github.com> Co-authored-by: Niklas Wenzel <dev@nikwen.de>
49 lines
1.6 KiB
Markdown
49 lines
1.6 KiB
Markdown
# webUtils
|
|
|
|
> A utility layer to interact with Web API objects (Files, Blobs, etc.)
|
|
|
|
Process: [Renderer](../glossary.md#renderer-process)
|
|
|
|
> [!IMPORTANT]
|
|
> If you want to call this API from a renderer process with context isolation enabled,
|
|
> place the API call in your preload script and
|
|
> [expose](../tutorial/context-isolation.md#after-context-isolation-enabled) it using the
|
|
> [`contextBridge`](context-bridge.md) API.
|
|
|
|
## Methods
|
|
|
|
The `webUtils` module has the following methods:
|
|
|
|
### `webUtils.getPathForFile(file)`
|
|
|
|
* `file` File - A web [File](https://developer.mozilla.org/en-US/docs/Web/API/File) object.
|
|
|
|
Returns `string` - The file system path that this `File` object points to. In the case where the object passed in is not a `File` object an exception is thrown. In the case where the File object passed in was constructed in JS and is not backed by a file on disk an empty string is returned.
|
|
|
|
This method superseded the previous augmentation to the `File` object with the `path` property. An example is included below.
|
|
|
|
```js @ts-nocheck
|
|
// Before (renderer)
|
|
const oldPath = document.querySelector('input[type=file]').files[0].path
|
|
```
|
|
|
|
```js @ts-nocheck
|
|
// After
|
|
|
|
// Renderer:
|
|
|
|
const file = document.querySelector('input[type=file]').files[0]
|
|
electronApi.doSomethingWithFile(file)
|
|
|
|
// Preload script:
|
|
|
|
const { contextBridge, webUtils } = require('electron')
|
|
|
|
contextBridge.exposeInMainWorld('electronApi', {
|
|
doSomethingWithFile (file) {
|
|
const path = webUtils.getPathForFile(file)
|
|
// Do something with the path, e.g., send it over IPC to the main process.
|
|
// It's best not to expose the full file path to the web content if possible.
|
|
}
|
|
})
|
|
```
|