es-toolkit/dist/string/trim.mjs

A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.

import { trimEnd } from "./trimEnd.mjs";
import { trimStart } from "./trimStart.mjs";
//#region src/string/trim.ts
/**
* Removes leading and trailing whitespace or specified characters from a string.
*
* @param str - The string from which characters will be trimmed.
* @param chars - The character(s) to remove from the string. Can be a single character or an array of characters.
* @returns The resulting string after the specified characters have been removed.
*
* @example
* trim("  hello  "); // "hello"
* trim("--hello--", "-"); // "hello"
* trim("##hello##", ["#", "o"]); // "hell"
*/
function trim(str, chars) {
	if (chars === void 0) return str.trim();
	return trimStart(trimEnd(str, chars), chars);
}
//#endregion
export { trim };