electron/docs/api/file-object.md

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

37 lines
1,013 B
Markdown
Raw Normal View History

2016-05-20 16:25:10 +00:00
# `File` Object
2014-10-25 06:58:32 +00:00
2016-04-21 22:39:12 +00:00
> Use the HTML5 `File` API to work natively with files on the filesystem.
> **Warning**
> The `path` property that Electron adds to the `File` interface is deprecated
> and **will** be removed in a future Electron release. We recommend you
> use `webUtils.getPathForFile` instead.
2015-08-26 23:41:25 +00:00
The DOM's File interface provides abstraction around native files in order to
2015-08-25 12:48:24 +00:00
let users work on native files directly with the HTML5 file API. Electron has
2015-08-26 23:41:25 +00:00
added a `path` attribute to the `File` interface which exposes the file's real
path on filesystem.
2014-10-25 06:58:32 +00:00
2016-11-03 17:26:00 +00:00
Example of getting a real path from a dragged-onto-the-app file:
2014-10-25 06:58:32 +00:00
```html
<div id="holder">
Drag your file here
</div>
<script>
document.addEventListener('drop', (e) => {
e.preventDefault();
e.stopPropagation();
for (const f of e.dataTransfer.files) {
console.log('File(s) you dragged here: ', f.path)
}
});
document.addEventListener('dragover', (e) => {
e.preventDefault();
e.stopPropagation();
});
2014-10-25 06:58:32 +00:00
</script>
```