Function toFile

packages/core/src/v3/apiClient/core.ts:370–400

(
  value: ToFileInput | PromiseLike<ToFileInput>,
  name?: string | null | undefined,
  options?: FilePropertyBag | undefined
)

 * @returns a {@link File} with the given properties
 */
export async function toFile(
  value: ToFileInput | PromiseLike<ToFileInput>,
  name?: string | null | undefined,
  options?: FilePropertyBag | undefined
): Promise<FileLike> {
  // If it's a promise, resolve it.
  value = await value;

  // Use the file's options if there isn't one provided
  options ??= isFileLike(value) ? { lastModified: value.lastModified, type: value.type } : {};

  if (isResponseLike(value)) {
    const blob = await value.blob();
    name ||= new URL(value.url).pathname.split(/[\\/]/).pop() ?? "unknown_file";

    return new File([blob as any], name, options);
  }

  const bits = await getBytes(value);

  name ||= getName(value) ?? "unknown_file";

  if (!options.type) {
    const type = (bits[0] as any)?.type;
    if (typeof type === "string") {
      options = { ...options, type };
    }
  }

  return new File(bits, name, options);
}

function getName(value: any): string | undefined {
  return (