mirror of
https://github.com/outline/outline.git
synced 2026-11-20 21:23:06 +03:00
Co-authored-by: Tom Moor <380914+tommoor@users.noreply.github.com> Co-authored-by: linear-code[bot] <222613912+linear-code[bot]@users.noreply.github.com>
190 lines
5.1 KiB
TypeScript
190 lines
5.1 KiB
TypeScript
import { isMac } from "./browser";
|
|
import { isUrl } from "./urls";
|
|
|
|
/**
|
|
* Converts bytes to human readable string for display
|
|
* Uses binary units (1024-based) on Windows and decimal units (1000-based) on macOS
|
|
*
|
|
* @param bytes filesize in bytes
|
|
* @returns Human readable filesize as a string
|
|
*/
|
|
export function bytesToHumanReadable(bytes: number | undefined) {
|
|
if (!bytes) {
|
|
return "0 Bytes";
|
|
}
|
|
|
|
// Use decimal units (base 1000) on macOS, binary units (base 1024) on other platforms
|
|
const useMacUnits = isMac;
|
|
const base = useMacUnits ? 1000 : 1024;
|
|
const threshold = useMacUnits ? 1000 : 1024;
|
|
|
|
if (bytes < threshold) {
|
|
return bytes + " Bytes";
|
|
}
|
|
|
|
const units = ["Bytes", "KB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"];
|
|
const exponent = Math.floor(Math.log(bytes) / Math.log(base));
|
|
const value = bytes / Math.pow(base, exponent);
|
|
|
|
// Format to 2 decimal places and remove trailing zeros
|
|
const formatted = parseFloat(value.toFixed(2));
|
|
|
|
return `${formatted} ${units[exponent]}`;
|
|
}
|
|
|
|
/**
|
|
* Get an image URL from a drag or clipboard event
|
|
*
|
|
* @param event The event to get the image from.
|
|
* @returns The URL of the image.
|
|
*/
|
|
export function getDataTransferImage(
|
|
event: React.DragEvent<HTMLElement> | DragEvent | ClipboardEvent
|
|
) {
|
|
const dt =
|
|
event instanceof ClipboardEvent ? event.clipboardData : event.dataTransfer;
|
|
const untrustedHTML = dt?.getData("text/html");
|
|
|
|
try {
|
|
const src = untrustedHTML
|
|
? new DOMParser()
|
|
.parseFromString(untrustedHTML, "text/html")
|
|
.querySelector("img")?.src
|
|
: dt?.getData("url");
|
|
|
|
// Validate URL to prevent XSS attacks
|
|
if (src && typeof src === "string") {
|
|
// Allow relative URLs starting with /
|
|
if (src.startsWith("/")) {
|
|
return src;
|
|
}
|
|
|
|
// Allow data URLs only for images
|
|
if (src.toLowerCase().startsWith("data:image/")) {
|
|
return src;
|
|
}
|
|
|
|
// For all other URLs, use isUrl which blocks dangerous protocols
|
|
if (
|
|
isUrl(src, {
|
|
requireProtocol: false,
|
|
requireHostname: false,
|
|
})
|
|
) {
|
|
return src;
|
|
}
|
|
}
|
|
|
|
return;
|
|
} catch (_err) {
|
|
return;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get an array of File objects from a drag or clipboard event
|
|
*
|
|
* @param event The event to get files from.
|
|
* @returns An array of files.
|
|
*/
|
|
export function getDataTransferFiles(
|
|
event: React.DragEvent<HTMLElement> | DragEvent | ClipboardEvent
|
|
): File[] {
|
|
const dt =
|
|
event instanceof ClipboardEvent ? event.clipboardData : event.dataTransfer;
|
|
|
|
if (dt) {
|
|
if ("files" in dt && dt.files.length) {
|
|
return dt.files ? Array.prototype.slice.call(dt.files) : [];
|
|
}
|
|
|
|
if ("items" in dt && dt.items.length) {
|
|
return dt.items
|
|
? Array.prototype.slice
|
|
.call(dt.items)
|
|
.filter((dti: DataTransferItem) => dti.kind !== "string")
|
|
.map((dti: DataTransferItem) => dti.getAsFile())
|
|
.filter((file: File | null): file is File => file !== null)
|
|
: [];
|
|
}
|
|
}
|
|
|
|
return [];
|
|
}
|
|
|
|
/**
|
|
* Get an array of Files from an input event
|
|
*
|
|
* @param event The react or native input event
|
|
* @returns An array of Files
|
|
*/
|
|
export function getEventFiles(
|
|
event: React.ChangeEvent<HTMLInputElement> | Event
|
|
): File[] {
|
|
return event.target && "files" in event.target
|
|
? Array.prototype.slice.call(event.target.files)
|
|
: [];
|
|
}
|
|
|
|
/**
|
|
* Get the likely filename from a URL
|
|
*
|
|
* @param url The URL to get the filename from
|
|
* @returns The filename or null if it could not be determined
|
|
*/
|
|
export function getFileNameFromUrl(url: string) {
|
|
try {
|
|
const urlObj = new URL(url);
|
|
const pathname = urlObj.pathname;
|
|
const filename = pathname.substring(pathname.lastIndexOf("/") + 1);
|
|
|
|
try {
|
|
// Decode percent-encoding so the name is human readable (e.g. "My%20File.pdf" → "My File.pdf").
|
|
return decodeURIComponent(filename);
|
|
} catch (_err) {
|
|
// Malformed percent-encoding, fall back to the raw filename.
|
|
return filename;
|
|
}
|
|
} catch (_err) {
|
|
return null;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Converts a base64 or percent-encoded data URL to a Blob.
|
|
*
|
|
* @param dataURL the data URL to convert.
|
|
* @returns the decoded Blob.
|
|
* @throws Error if the data URL is invalid.
|
|
*/
|
|
export const dataUrlToBlob = (dataURL: string): Blob => {
|
|
const comma = dataURL.indexOf(",");
|
|
if (!dataURL.startsWith("data:") || comma === -1) {
|
|
throw new Error("Invalid data URL");
|
|
}
|
|
|
|
const metadata = dataURL.slice(5, comma);
|
|
const mime = metadata.split(";")[0] || "image/png";
|
|
const data = decodeURIComponent(dataURL.slice(comma + 1));
|
|
const bytes = /;base64$/i.test(metadata)
|
|
? Uint8Array.from(atob(data), (char) => char.charCodeAt(0))
|
|
: new TextEncoder().encode(data);
|
|
|
|
return new Blob([bytes], {
|
|
type: mime,
|
|
});
|
|
};
|
|
|
|
/**
|
|
* Converts a data URL to a File.
|
|
*
|
|
* @param dataURL the data URL to convert.
|
|
* @param filename the filename to use.
|
|
* @returns the decoded File.
|
|
* @throws Error if the data URL is invalid.
|
|
*/
|
|
export const dataUrlToFile = (dataURL: string, filename: string): File => {
|
|
const blob = dataUrlToBlob(dataURL);
|
|
return new File([blob], filename, { type: blob.type });
|
|
};
|