mirror of
https://github.com/denoland/std.git
synced 2024-11-21 20:50:22 +00:00
71 lines
2.4 KiB
TypeScript
71 lines
2.4 KiB
TypeScript
// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
|
|
// This module is browser compatible.
|
|
|
|
import { getLogger } from "./get_logger.ts";
|
|
import type { GenericFunction } from "./logger.ts";
|
|
import "./setup.ts";
|
|
|
|
/**
|
|
* Log at the critical level.
|
|
*
|
|
* This function is a pass-through to the default logger's `critical` method. By
|
|
* default, the default logger is configured to use {@linkcode console.log} and
|
|
* print in bold red text.
|
|
*
|
|
* @template T The type of the message to log.
|
|
* @param msg The message to log.
|
|
* @param args Arguments to be formatted into the message.
|
|
* @returns The message that was logged.
|
|
*
|
|
* @example Usage
|
|
* ```ts
|
|
* import { critical } from "@std/log/critical";
|
|
* import { assertEquals } from "@std/assert/equals";
|
|
*
|
|
* assertEquals(critical("This is a critical message."), "This is a critical message.");
|
|
* // Prints: "CRITICAL This is a critical message."
|
|
*
|
|
* assertEquals(critical(() => "This is a critical message."), "This is a critical message.");
|
|
* // Prints: "CRITICAL This is a critical message."
|
|
* ```
|
|
*/
|
|
export function critical<T>(msg: () => T, ...args: unknown[]): T | undefined;
|
|
/**
|
|
* Log at the critical level.
|
|
*
|
|
* This function is a pass-through to the default logger's `critical` method. By
|
|
* default, the default logger is configured to use {@linkcode console.log} and
|
|
* print in bold red text.
|
|
*
|
|
* @template T The type of the message to log.
|
|
* @param msg The message to log.
|
|
* @param args Arguments to be formatted into the message.
|
|
* @returns The message that was logged.
|
|
*
|
|
* @example Usage
|
|
* ```ts
|
|
* import { critical } from "@std/log/critical";
|
|
* import { assertEquals } from "@std/assert/equals";
|
|
*
|
|
* assertEquals(critical("This is a critical message."), "This is a critical message.");
|
|
* // Prints: "CRITICAL This is a critical message."
|
|
*
|
|
* assertEquals(critical(() => "This is a critical message."), "This is a critical message.");
|
|
* // Prints: "CRITICAL This is a critical message."
|
|
* ```
|
|
*/
|
|
export function critical<T>(
|
|
msg: T extends GenericFunction ? never : T,
|
|
...args: unknown[]
|
|
): T;
|
|
export function critical<T>(
|
|
msg: (T extends GenericFunction ? never : T) | (() => T),
|
|
...args: unknown[]
|
|
): T | undefined {
|
|
// Assist TS compiler with pass-through generic type
|
|
if (msg instanceof Function) {
|
|
return getLogger("default").critical(msg, ...args);
|
|
}
|
|
return getLogger("default").critical(msg, ...args);
|
|
}
|