createObjectURL

Create an object URL from Blob, ArrayBuffer, or Response.

API

createObjectURL

Return

Argument	Description	Type
Promise<string>	Promise that resolves to object URL	Promise

Parameters

Parameter	Description	Type	Default
src	Data source	Blob | ArrayBuffer | Response | string	Required

Example

Basic Usage (Blob)

import { createObjectURL } from 'ranuts';

const blob = new Blob(['Hello World'], { type: 'text/plain' });
const url = await createObjectURL(blob);
console.log(url); // 'blob:http://example.com/...'

Create from ArrayBuffer

import { createObjectURL } from 'ranuts';

const buffer = new ArrayBuffer(8);
const url = await createObjectURL(buffer);
console.log(url); // 'blob:http://example.com/...'

Create from Response

import { createObjectURL } from 'ranuts';

const response = await fetch('https://example.com/image.jpg');
const url = await createObjectURL(response);
console.log(url); // 'blob:http://example.com/...'

Handle String

import { createObjectURL } from 'ranuts';

// If string is passed, returns directly
const url = await createObjectURL('https://example.com/image.jpg');
console.log(url); // 'https://example.com/image.jpg'

Image Preview

import { createObjectURL } from 'ranuts';

async function previewImage(file) {
  const url = await createObjectURL(file);
  document.getElementById('preview').src = url;
}

Notes

1. Async operation: Returns Promise, needs to be handled with await or .then().
2. Type support: Supports Blob, ArrayBuffer, Response, and string types.
3. Memory management: Created URLs need to manually call URL.revokeObjectURL() to free memory.
4. Use case: Commonly used for file preview, temporary URL generation, image processing, etc.