@wordpress/blob 4.54.1-next.v.202608281122.0 → 4.55.0

package/CHANGELOG.md

@@ -2,6 +2,8 @@
 
 ## Unreleased
 
+## 4.55.0 (2026-09-10)
+
 ## 4.54.0 (2026-08-26)
 
 ### Internal

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/blob",
-	"version": "4.54.1-next.v.202608281122.0",
+	"version": "4.55.0",
 	"description": "Blob utilities for WordPress.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",
@@ -23,7 +23,6 @@
 		"npm": ">=8.19.2"
 	},
 	"files": [
-		"src",
 		"build",
 		"build-module",
 		"build-types",
@@ -43,12 +42,13 @@
 	"types": "build-types",
 	"sideEffects": false,
 	"devDependencies": {
-		"@testing-library/jest-dom": "^6.9.1",
+		"@testing-library/jest-dom": "^7.0.1",
 		"@types/jest": "^30.0.0",
-		"@types/node": "^20.19.39"
+		"@types/node": "^24.13.3",
+		"vitest": "^5.0.0"
 	},
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "de479d415171765f7b573c81aeec5334ff506a12"
+	"gitHead": "485f42ae8a1c58ceea18371a507fd4acfa86fbd8"
 }

package/src/index.ts

@@ -1,113 +0,0 @@
-const cache: Record< string, File > = {};
-
-/**
- * Create a blob URL from a file.
- *
- * @param file The file to create a blob URL for.
- *
- * @return The blob URL.
- */
-export function createBlobURL( file: File ): string {
-	const url = window.URL.createObjectURL( file );
-
-	cache[ url ] = file;
-
-	return url;
-}
-
-/**
- * Retrieve a file based on a blob URL. The file must have been created by
- * `createBlobURL` and not removed by `revokeBlobURL`, otherwise it will return
- * `undefined`.
- *
- * @param url The blob URL.
- *
- * @return The file for the blob URL.
- */
-export function getBlobByURL( url: string ): File | undefined {
-	return cache[ url ];
-}
-
-/**
- * Retrieve a blob type based on URL. The file must have been created by
- * `createBlobURL` and not removed by `revokeBlobURL`, otherwise it will return
- * `undefined`.
- *
- * @param url The blob URL.
- *
- * @return The blob type.
- */
-export function getBlobTypeByURL( url: string ): string | undefined {
-	return getBlobByURL( url )?.type.split( '/' )[ 0 ]; // 0: media type , 1: file extension eg ( type: 'image/jpeg' ).
-}
-
-/**
- * Remove the resource and file cache from memory.
- *
- * @param url The blob URL.
- */
-export function revokeBlobURL( url: string ): void {
-	if ( cache[ url ] ) {
-		window.URL.revokeObjectURL( url );
-	}
-
-	delete cache[ url ];
-}
-
-/**
- * Check whether a url is a blob url.
- *
- * @param url The URL.
- *
- * @return Is the url a blob url?
- */
-export function isBlobURL( url: string | undefined ): boolean {
-	if ( ! url || ! url.indexOf ) {
-		return false;
-	}
-	return url.indexOf( 'blob:' ) === 0;
-}
-
-/**
- * Downloads a file, e.g., a text or readable stream, in the browser.
- * Appropriate for downloading smaller file sizes, e.g., < 5 MB.
- *
- * Example usage:
- *
- * ```js
- * 	const fileContent = JSON.stringify(
- * 		{
- * 			"title": "My Post",
- * 		},
- * 		null,
- * 		2
- * 	);
- * 	const filename = 'file.json';
- *
- * 	downloadBlob( filename, fileContent, 'application/json' );
- * ```
- *
- * @param filename    File name.
- * @param content     File content (BufferSource | Blob | string).
- * @param contentType (Optional) File mime type. Default is `''`.
- */
-export function downloadBlob(
-	filename: string,
-	content: BlobPart,
-	contentType: string = ''
-): void {
-	if ( ! filename || ! content ) {
-		return;
-	}
-
-	const file = new window.Blob( [ content ], { type: contentType } );
-	const url = window.URL.createObjectURL( file );
-	const anchorElement = document.createElement( 'a' );
-	anchorElement.href = url;
-	anchorElement.download = filename;
-	anchorElement.style.display = 'none';
-	document.body.appendChild( anchorElement );
-	anchorElement.click();
-	document.body.removeChild( anchorElement );
-	window.URL.revokeObjectURL( url );
-}

package/src/test/index.ts

@@ -1,92 +0,0 @@
-import { isBlobURL, getBlobTypeByURL, downloadBlob } from '..';
-
-describe( 'isBlobURL', () => {
-	it( 'returns true if the url starts with "blob:"', () => {
-		expect( isBlobURL( 'blob:thisbitdoesnotmatter' ) ).toBe( true );
-	} );
-
-	it( 'returns false if the url does not start with "blob:"', () => {
-		expect( isBlobURL( 'https://www.example.com' ) ).toBe( false );
-	} );
-
-	it( 'returns false if the url is not defined', () => {
-		expect(
-			// @ts-expect-error This is not a valid call according to types.
-			isBlobURL()
-		).toBe( false );
-	} );
-} );
-
-describe( 'getBlobTypeByURL', () => {
-	it( 'returns undefined if the blob is not found', () => {
-		expect( getBlobTypeByURL( 'blob:notexisting' ) ).toBeUndefined();
-	} );
-
-	it( 'returns undefined if the url is not defined', () => {
-		expect(
-			// @ts-expect-error This is not a valid call according to types.
-			getBlobTypeByURL()
-		).toBeUndefined();
-	} );
-} );
-
-describe( 'downloadBlob', () => {
-	const originalURL = window.URL;
-	const createObjectURL = jest.fn().mockReturnValue( 'blob:pannacotta' );
-	const revokeObjectURL = jest.fn().mockReturnValue( false );
-	const mockAnchorElement = document.createElement( 'a' );
-	mockAnchorElement.click = jest.fn();
-	const createElementSpy = jest
-		.spyOn( global.document, 'createElement' )
-		.mockReturnValue( mockAnchorElement );
-
-	const mockBlob = jest.fn();
-	const blobSpy = jest
-		.spyOn( window, 'Blob' )
-		.mockReturnValue( mockBlob as unknown as Blob );
-	jest.spyOn( document.body, 'appendChild' );
-	jest.spyOn( document.body, 'removeChild' );
-	beforeEach( () => {
-		// Can't seem to spy on these static methods. They are `undefined`.
-		// Possibly overwritten: https://github.com/WordPress/gutenberg/blob/trunk/packages/jest-preset-default/scripts/setup-globals.js#L5
-		// @ts-expect-error This is not a valid URL object.
-		window.URL = {
-			createObjectURL,
-			revokeObjectURL,
-		};
-	} );
-
-	afterAll( () => {
-		window.URL = originalURL;
-	} );
-
-	it( 'requires a filename argument', () => {
-		downloadBlob( '', '{}', 'application/json' );
-		expect( blobSpy ).not.toHaveBeenCalled();
-	} );
-
-	it( 'requires a content argument', () => {
-		downloadBlob( 'text.txt', '', 'text/plain' );
-		expect( blobSpy ).not.toHaveBeenCalled();
-	} );
-
-	it( 'constructs an anchor element with attributes and removes it', () => {
-		downloadBlob( 'filename.json', '{}', 'application/json' );
-		expect( blobSpy ).toHaveBeenCalledWith( [ '{}' ], {
-			type: 'application/json',
-		} );
-		expect( createObjectURL ).toHaveBeenCalledWith( mockBlob );
-		expect( createElementSpy ).toHaveBeenCalledWith( 'a' );
-		expect( mockAnchorElement.download ).toBe( 'filename.json' );
-		expect( mockAnchorElement.href ).toBe( 'blob:pannacotta' );
-		expect( mockAnchorElement ).toHaveStyle( 'display:none' );
-		expect( document.body.appendChild ).toHaveBeenCalledWith(
-			mockAnchorElement
-		);
-		expect( mockAnchorElement.click ).toHaveBeenCalledTimes( 1 );
-		expect( document.body.removeChild ).toHaveBeenCalledWith(
-			mockAnchorElement
-		);
-		expect( revokeObjectURL ).toHaveBeenCalled();
-	} );
-} );