Carlos Florêncio
77 lines
2.5 KiB
TypeScript
77 lines
2.5 KiB
TypeScript
import { retainNativeBlobDownload, revokeNativeBlobDownload } from "./native-blob-download";
|
|
|
|
export type TriggerFileDownloadParams = {
|
|
fileName: string;
|
|
content: string;
|
|
isBinary: boolean;
|
|
};
|
|
|
|
/** Return the last path segment of a POSIX or Windows path. */
|
|
export function fileBasename(path: string): string {
|
|
const idx = Math.max(path.lastIndexOf("/"), path.lastIndexOf("\\"));
|
|
return idx >= 0 ? path.slice(idx + 1) : path;
|
|
}
|
|
|
|
function base64ToArrayBuffer(base64: string): ArrayBuffer {
|
|
const binary = atob(base64);
|
|
const buffer = new ArrayBuffer(binary.length);
|
|
const view = new Uint8Array(buffer);
|
|
for (let i = 0; i < binary.length; i++) view[i] = binary.charCodeAt(i);
|
|
return buffer;
|
|
}
|
|
|
|
function downloadBlobViaAnchor(blob: Blob, fileName: string): void {
|
|
const url = URL.createObjectURL(blob);
|
|
const nativeDownload = retainNativeBlobDownload(url);
|
|
try {
|
|
const anchor = document.createElement("a");
|
|
anchor.href = url;
|
|
anchor.download = fileName;
|
|
document.body.appendChild(anchor);
|
|
anchor.click();
|
|
document.body.removeChild(anchor);
|
|
} catch (error) {
|
|
if (nativeDownload) revokeNativeBlobDownload(url);
|
|
else URL.revokeObjectURL(url);
|
|
throw error;
|
|
}
|
|
if (!nativeDownload) {
|
|
window.setTimeout(() => URL.revokeObjectURL(url), 0);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Trigger a browser download for the given file content by creating a Blob
|
|
* and clicking a temporary anchor. Binary content is expected to be
|
|
* base64-encoded (matches the workspace.file.get contract).
|
|
*/
|
|
export function triggerFileDownload({
|
|
fileName,
|
|
content,
|
|
isBinary,
|
|
}: TriggerFileDownloadParams): void {
|
|
const blob = isBinary
|
|
? new Blob([base64ToArrayBuffer(content)], { type: "application/octet-stream" })
|
|
: new Blob([content], { type: "text/plain;charset=utf-8" });
|
|
downloadBlobViaAnchor(blob, fileBasename(fileName));
|
|
}
|
|
|
|
/**
|
|
* Trigger a browser download for a Blob already in hand (e.g. a fetch
|
|
* response body), under an explicit file name. Unlike triggerFileDownload,
|
|
* the name is used as-is rather than reduced to a basename, since callers
|
|
* pass a download name directly rather than a source path.
|
|
*/
|
|
export function triggerBlobDownload(blob: Blob, fileName: string): void {
|
|
downloadBlobViaAnchor(blob, fileName);
|
|
}
|
|
|
|
export function triggerUrlDownload(url: string, fileName: string): void {
|
|
const anchor = document.createElement("a");
|
|
anchor.href = url;
|
|
anchor.download = fileName;
|
|
document.body.appendChild(anchor);
|
|
anchor.click();
|
|
anchor.remove();
|
|
}
|