Files
libsignal/node/ts/WebpSanitizer.ts
2026-03-16 18:55:17 -07:00

33 lines
904 B
TypeScript

//
// Copyright 2023 Signal Messenger, LLC.
// SPDX-License-Identifier: AGPL-3.0-only
//
/**
* A WebP format “sanitizer”.
*
* The sanitizer currently simply checks the validity of a WebP file input, so that passing a malformed file to an
* unsafe parser can be avoided.
*
* @module WebpSanitizer
*/
import * as Native from './Native.js';
import type {
IoError,
InvalidMediaInputError,
UnsupportedMediaInputError,
} from './Errors.js';
/**
* Sanitize a WebP input.
*
* @param input A WebP format input stream.
* @throws {IoError} If an IO error on the input occurs.
* @throws {InvalidMediaInputError} If the input could not be parsed because it was invalid.
* @throws {UnsupportedMediaInputError} If the input could not be parsed because it's unsupported in some way.
*/
export function sanitize(input: Uint8Array<ArrayBuffer>): void {
Native.WebpSanitizer_Sanitize(input);
}