[CB-6393] Make {File|Directory}Entry.toURL() return something useful for developers

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Component/s: cordova-plugin-file
• Assignee: Ian Clelland
• Reporter: Ian Clelland
• Created: 02/Apr/14 20:19
• Updated: 23/Aug/18 07:19
• Resolved: 04/Apr/14 17:40

Description

Relevant mailing list thread

FileEntry.toURL() and DirectoryEntry.toURL() should return, by default, URLs which are usable by the webview, as src for video, audio and image tags.

Practically, this means that .toURL() should return the same values as .toNativeURL() currently does: a file URL if possible; a content (Android) or assets-library (iOS) library if that's required, or a cdvfile URL as a last resort.

.toNativeURL should stick around for a while (with a deprecation notice) since it's been released, and I've advocated its use on various forums. It should have exactly the same semantics as .toURL though.

We can introduce a .toInternalURL method to format cdvfile URLs for passing over the bridge, since that is the format that the native side of the file plugin expects, and it would be nice to have a single place where that conversion is done.