@technobuddha/library/dist/matches.js

A large library of useful functions

import { isRegExp } from "./is-reg-exp.js";
import { isString } from "./is-string.js";
/**
 * Determines if the given `text` matches the provided `match` criteria.
 *
 * The `match` parameter can be:
 * - A string: returns true if the trimmed, lowercased `text` is equal to the lowercased `match` string.
 * - A RegExp: returns true if the regular expression matches the trimmed, lowercased `text`.
 * - An iterable of strings or RegExps: returns true if any of the elements match the `text` as described above.
 * @param text - The input string to test against the match criteria.
 * @param match - A string, RegExp, or iterable of strings/RegExps to match against the input text.
 * @returns `true` if the text matches the criteria; otherwise, `false`.
 * @group RegExp
 * @category Operations
 * @example
 * ```typescript
 * matches('Hello', 'hello'); // true
 * matches('Hello', /he.*\/ui); // true
 * matches('Hello', ['hi', /he.*\/ui]); // true
 * matches('Hello', ['hi', 'hey']); // false
 * ```
 */
export function matches(text, match) {
    const str = text.trim().toLocaleLowerCase();
    if (isRegExp(match)) {
        return match.test(str);
    }
    if (isString(match)) {
        return match.toLocaleLowerCase() === str;
    }
    for (const m of match) {
        if ((isRegExp(m) && m.test(str)) || (isString(m) && m.toLocaleLowerCase() === str)) {
            return true;
        }
    }
    return false;
}
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWF0Y2hlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9tYXRjaGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQUMzQyxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sZ0JBQWdCLENBQUM7QUFFMUM7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FtQkc7QUFDSCxNQUFNLFVBQVUsT0FBTyxDQUFDLElBQVksRUFBRSxLQUFrRDtJQUN0RixNQUFNLEdBQUcsR0FBRyxJQUFJLENBQUMsSUFBSSxFQUFFLENBQUMsaUJBQWlCLEVBQUUsQ0FBQztJQUU1QyxJQUFJLFFBQVEsQ0FBQyxLQUFLLENBQUMsRUFBRSxDQUFDO1FBQ3BCLE9BQU8sS0FBSyxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsQ0FBQztJQUN6QixDQUFDO0lBQ0QsSUFBSSxRQUFRLENBQUMsS0FBSyxDQUFDLEVBQUUsQ0FBQztRQUNwQixPQUFPLEtBQUssQ0FBQyxpQkFBaUIsRUFBRSxLQUFLLEdBQUcsQ0FBQztJQUMzQyxDQUFDO0lBRUQsS0FBSyxNQUFNLENBQUMsSUFBSSxLQUFLLEVBQUUsQ0FBQztRQUN0QixJQUFJLENBQUMsUUFBUSxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLENBQUMsaUJBQWlCLEVBQUUsS0FBSyxHQUFHLENBQUMsRUFBRSxDQUFDO1lBQ25GLE9BQU8sSUFBSSxDQUFDO1FBQ2QsQ0FBQztJQUNILENBQUM7SUFFRCxPQUFPLEtBQUssQ0FBQztBQUNmLENBQUMifQ==