”工欲善其事,必先利其器。“—孔子《论语.录灵公》
首页 > 编程 > LogTape .eleased:有什么新内容?

LogTape .eleased:有什么新内容?

发布于2024-11-13
浏览:206

LogTape .eleased: What

LogTape,一个用于 JavaScript 和 TypeScript 的零依赖结构化日志库,已发布 v0.6.0。发生了什么变化?

覆盖父记录器的接收器

LogTape 的功能之一是通过分层类别继承接收器。例如,如果您设置两个记录器,如下所示:

import { configure, getConsoleSink, getFileSink } from "@logtape/logtape";

await configure({
  sinks: {
    console: getConsoleSink(),
    file:    getFileSink("app.log"),
  },
  loggers: [
    { category: ["app"],           level: "debug", sinks: ["file"] },
    { category: ["app", "module"], level: "debug", sinks: ["console"] },
  ],
});

写入 ["app"] 记录器的日志将仅保存到 app.log 文件,但写入 ["app", "module"] 记录器的日志将同时保存到 app.log 文件

app.log

文件并输出到控制台。这是因为 ["app", "module"] 记录器从其父类别 ["app"] 继承了接收器。 但是,有时您可能不希望出现这种行为。从 LogTape 0.6.0 开始,您现在可以
覆盖

父记录器的接收器。例如,如果您为子记录器启用parentSinks:“覆盖”选项,如下所示:
await configure({
  sinks: { /* omitted; same as above */ },
  loggers: [
    { category: ["app"],           level: "debug", sinks: ["file"] },
    { category: ["app", "module"], level: "debug", sinks: ["console"], parentSinks: "override" },
  ],
});

等待配置({ 汇:{ /* 省略;与上面相同*/ }, 记录器:[ { 类别:[“应用程序”],级别:“调试”,接收器:[“文件”] }, { 类别:[“应用程序”,“模块”],级别:“调试”,接收器:[“控制台”],parentSinks:“覆盖”}, ], }); 写入["app"]记录器的日志只会保存到

app.log

文件,写入["app","module"]记录器的日志只会输出到控制台。这是因为子记录器 ["app", "module"] 覆盖了 ["app"] 记录器的接收器。

当然,默认值是parentSinks: "inherit",所以如果你不指定该选项,它的行为会和以前一样。

如果您想了解此功能添加的背景,请参阅 GitHub Issue #15。

允许消息模板中的占位符使用前导/尾随空格

在以前的版本中,如果您这样登录:
await configure({
  sinks: { /* omitted; same as above */ },
  loggers: [
    { category: ["app"],           level: "debug", sinks: ["file"] },
    { category: ["app", "module"], level: "debug", sinks: ["console"], parentSinks: "override" },
  ],
});

logger.info("你好,{ name }!", { name: "Alice" });

与预期相反,一条日志Hello, undefined!将被创建。这是因为占位符 { name } 包含空格字符,因此它查找属性“ name ”而不是“ name ”。换句话说,您必须从占位符中删除空格,如下所示:
await configure({
  sinks: { /* omitted; same as above */ },
  loggers: [
    { category: ["app"],           level: "debug", sinks: ["file"] },
    { category: ["app", "module"], level: "debug", sinks: ["console"], parentSinks: "override" },
  ],
});

logger.info("你好,{name}!", { name: "Alice" });

或者在实际属性名称中添加相同的空格,如下所示:
await configure({
  sinks: { /* omitted; same as above */ },
  loggers: [
    { category: ["app"],           level: "debug", sinks: ["file"] },
    { category: ["app", "module"], level: "debug", sinks: ["console"], parentSinks: "override" },
  ],
});

logger.info("你好,{ name }!", { " name ": "Alice" });

虽然这并不是严格意义上的错误,但根据编码习惯,它是容易出错的行为。

但是,从LogTape 0.6.0开始,即使占位符的开头和结尾有空格,它也会寻找不带空格的属性名称。例如,如果您像这样登录:
await configure({
  sinks: { /* omitted; same as above */ },
  loggers: [
    { category: ["app"],           level: "debug", sinks: ["file"] },
    { category: ["app", "module"], level: "debug", sinks: ["console"], parentSinks: "override" },
  ],
});

logger.info("你好,{ name }!", { name: "Alice" });

正如预期的那样,日志是Hello, Alice!将被创建。

但是,如果有一个属性完全匹配(包括空格字符),则该属性将被优先考虑。例如,如果您像这样登录:
await configure({
  sinks: { /* omitted; same as above */ },
  loggers: [
    { category: ["app"],           level: "debug", sinks: ["file"] },
    { category: ["app", "module"], level: "debug", sinks: ["console"], parentSinks: "override" },
  ],
});

logger.info("你好,{ name }!", { name: "Alice", " name ": "Bob" });

你好,鲍勃!将被记录而不是你好,爱丽丝!。

如果您想了解此功能添加的背景,请参阅 GitHub Issue #16。

LogRecord.rawMessage 属性

LogRecord 是一种数据类型,表示在 LogTape 输出和格式化之前的日志。

虽然 LogRecord.message 属性已经存在,但该属性包含消息模板中的占位符替换为实际属性值后的结果。这在大多数情况下已经足够了,但是当日志输出目的地(接收器)是另一个日志系统时,您可能希望分别输出原始消息模板和属性值,从而允许接收日志系统用属性替换消息模板中的占位符直接值。

LogTape 0.6.0 中添加的 LogRecord.rawMessage 正是用于此目的的属性,其中包含消息模板的原始状态以及未替换的占位符。例如,如果您像这样登录:
await configure({
  sinks: { /* omitted; same as above */ },
  loggers: [
    { category: ["app"],           level: "debug", sinks: ["file"] },
    { category: ["app", "module"], level: "debug", sinks: ["console"], parentSinks: "override" },
  ],
});

logger.info("你好,{name}!", { name: "Alice" });

虽然 LogRecord.message 将包含值 ["Hello, ", "Alice", "!"],但 LogRecord.rawMessage 将包含值 "Hello, {name}!"。

如果您想了解此功能添加的背景,请参阅 GitHub Issue #17。

可定制的内置文本格式化程序

文本格式化程序是一个接口,它确定每个日志如何在流接收器、文件接收器等中格式化为文本。实际的类型定义非常简单:
await configure({
  sinks: { /* omitted; same as above */ },
  loggers: [
    { category: ["app"],           level: "debug", sinks: ["file"] },
    { category: ["app", "module"], level: "debug", sinks: ["console"], parentSinks: "override" },
  ],
});

导出类型TextFormatter = (记录: LogRecord) => string;

但是,每次直接定义文本格式化程序可能会很麻烦,因此 LogTape 内置了 defaultTextFormatter 和 ansiColorFormatter 可供您使用。到目前为止,由于无法进行其他配置,因此您必须按原样接受预定格式。例如,如果您不喜欢像“警告”这样的日志级别输出为像 WRN 这样的三个字母缩写,则必须从头开始实现 TextFormatter。

但是,从 LogTape 0.6.0 开始,您可以通过 getDefaultTextFormatter() 和 getAnsiColorFormatter() 函数根据自己的喜好自定义各种格式设置,而无需从头开始实现 TextFormatter。

例如,如果要将“警告”这样的日志级别表示为单个大写字母W,可以这样配置:
await configure({
  sinks: { /* omitted; same as above */ },
  loggers: [
    { category: ["app"],           level: "debug", sinks: ["file"] },
    { category: ["app", "module"], level: "debug", sinks: ["console"], parentSinks: "override" },
  ],
});

const myFormatter = getDefaultTextFormatter({ level: "L" });

或者如果你想省略时间戳中的日期和时区,只显示时间,你可以这样配置:
await configure({
  sinks: { /* omitted; same as above */ },
  loggers: [
    { category: ["app"],           level: "debug", sinks: ["file"] },
    { category: ["app", "module"], level: "debug", sinks: ["console"], parentSinks: "override" },
  ],
});

const myFormatter = getDefaultTextFormatter({ 时间戳: "时间" });

更多格式化选项的说明,请参考相关文档。

如果您想了解此功能添加的背景,请参阅 GitHub Issue #13。

从 JSR 和 npm 获取

LogTape 0.6.0 已在 JSR 和 npm 上可用,所以立即获取!
await configure({
  sinks: { /* omitted; same as above */ },
  loggers: [
    { category: ["app"],           level: "debug", sinks: ["file"] },
    { category: ["app", "module"], level: "debug", sinks: ["console"], parentSinks: "override" },
  ],
});

deno 添加 @logtape/[email protected] # Deno npm 添加@logtape/[email protected] # npm pnpm 添加@logtape/[email protected] # pnpm 纱线添加 @logtape/[email protected] # 纱线 包子添加@logtape/[email protected] # 包子

祝您登录愉快!

LogTape .eleased: What

版本声明 本文转载于:https://dev.to/hongminhee/logtape-060-released-whats-new-17od?1如有侵犯,请联系[email protected]删除
最新教程 更多>
  • Java的Map.Entry和SimpleEntry如何简化键值对管理?
    Java的Map.Entry和SimpleEntry如何简化键值对管理?
    A Comprehensive Collection for Value Pairs: Introducing Java's Map.Entry and SimpleEntryIn Java, when defining a collection where each element com...
    编程 发布于2025-07-15
  • 用户本地时间格式及时区偏移显示指南
    用户本地时间格式及时区偏移显示指南
    在用户的语言环境格式中显示日期/时间,并使用时间偏移在向最终用户展示日期和时间时,以其localzone and格式显示它们至关重要。这确保了不同地理位置的清晰度和无缝用户体验。以下是使用JavaScript实现此目的的方法。方法:推荐方法是处理客户端的Javascript中的日期/时间格式化和时...
    编程 发布于2025-07-15
  • 人脸检测失败原因及解决方案:Error -215
    人脸检测失败原因及解决方案:Error -215
    错误处理:解决“ error:((-215)!empty()in Function Multultiscale中的“ openCV 要解决此问题,必须确保提供给HAAR CASCADE XML文件的路径有效。在提供的代码片段中,级联分类器装有硬编码路径,这可能对您的系统不准确。相反,OPENCV提...
    编程 发布于2025-07-15
  • 可以在纯CS中将多个粘性元素彼此堆叠在一起吗?
    可以在纯CS中将多个粘性元素彼此堆叠在一起吗?
    [2这里: https://webthemez.com/demo/sticky-multi-header-scroll/index.html </main> <section> { display:grid; grid-template-...
    编程 发布于2025-07-15
  • 切换到MySQLi后CodeIgniter连接MySQL数据库失败原因
    切换到MySQLi后CodeIgniter连接MySQL数据库失败原因
    无法连接到mySQL数据库:故障排除错误消息要调试问题,建议将以下代码添加到文件的末尾.//config/database.php并查看输出: ... ... 回声'... echo '<pre>'; print_r($db['default']); echo '</pr...
    编程 发布于2025-07-15
  • 如何从Python中的字符串中删除表情符号:固定常见错误的初学者指南?
    如何从Python中的字符串中删除表情符号:固定常见错误的初学者指南?
    从python import codecs import codecs import codecs 导入 text = codecs.decode('这狗\ u0001f602'.encode('utf-8'),'utf-8') 印刷(文字)#带有...
    编程 发布于2025-07-15
  • 如何使用组在MySQL中旋转数据?
    如何使用组在MySQL中旋转数据?
    在关系数据库中使用mySQL组使用mySQL组进行查询结果,在关系数据库中使用MySQL组,转移数据的数据是指重新排列的行和列的重排以增强数据可视化。在这里,我们面对一个共同的挑战:使用组的组将数据从基于行的基于列的转换为基于列。 Let's consider the following ...
    编程 发布于2025-07-15
  • 表单刷新后如何防止重复提交?
    表单刷新后如何防止重复提交?
    在Web开发中预防重复提交 在表格提交后刷新页面时,遇到重复提交的问题是常见的。要解决这个问题,请考虑以下方法: 想象一下具有这样的代码段,看起来像这样的代码段:)){ //数据库操作... 回声“操作完成”; 死(); } ?> ...
    编程 发布于2025-07-15
  • 如何克服PHP的功能重新定义限制?
    如何克服PHP的功能重新定义限制?
    克服PHP的函数重新定义限制在PHP中,多次定义一个相同名称的函数是一个no-no。尝试这样做,如提供的代码段所示,将导致可怕的“不能重新列出”错误。 但是,PHP工具腰带中有一个隐藏的宝石:runkit扩展。它使您能够灵活地重新定义函数。 runkit_function_renction_re...
    编程 发布于2025-07-15
  • `console.log`显示修改后对象值异常的原因
    `console.log`显示修改后对象值异常的原因
    foo = [{id:1},{id:2},{id:3},{id:4},{id:id:5},],]; console.log('foo1',foo,foo.length); foo.splice(2,1); console.log('foo2', foo, foo....
    编程 发布于2025-07-15
  • 如何使用不同数量列的联合数据库表?
    如何使用不同数量列的联合数据库表?
    合并列数不同的表 当尝试合并列数不同的数据库表时,可能会遇到挑战。一种直接的方法是在列数较少的表中,为缺失的列追加空值。 例如,考虑两个表,表 A 和表 B,其中表 A 的列数多于表 B。为了合并这些表,同时处理表 B 中缺失的列,请按照以下步骤操作: 确定表 B 中缺失的列,并将它们添加到表的末...
    编程 发布于2025-07-15
  • Java为何无法创建泛型数组?
    Java为何无法创建泛型数组?
    通用阵列创建错误 arrayList [2]; JAVA报告了“通用数组创建”错误。为什么不允许这样做?答案:Create an Auxiliary Class:public static ArrayList<myObject>[] a = new ArrayList<myO...
    编程 发布于2025-07-15
  • eval()vs. ast.literal_eval():对于用户输入,哪个Python函数更安全?
    eval()vs. ast.literal_eval():对于用户输入,哪个Python函数更安全?
    称量()和ast.literal_eval()中的Python Security 在使用用户输入时,必须优先确保安全性。强大的Python功能Eval()通常是作为潜在解决方案而出现的,但担心其潜在风险。 This article delves into the differences betwee...
    编程 发布于2025-07-15
  • 版本5.6.5之前,使用current_timestamp与时间戳列的current_timestamp与时间戳列有什么限制?
    版本5.6.5之前,使用current_timestamp与时间戳列的current_timestamp与时间戳列有什么限制?
    在时间戳列上使用current_timestamp或MySQL版本中的current_timestamp或在5.6.5 此限制源于遗留实现的关注,这些限制需要对当前的_timestamp功能进行特定的实现。 创建表`foo`( `Productid` int(10)unsigned not n...
    编程 发布于2025-07-15
  • 如何在Java中正确显示“ DD/MM/YYYY HH:MM:SS.SS”格式的当前日期和时间?
    如何在Java中正确显示“ DD/MM/YYYY HH:MM:SS.SS”格式的当前日期和时间?
    如何在“ dd/mm/yyyy hh:mm:mm:ss.ss”格式“ gormat 解决方案: args)抛出异常{ 日历cal = calendar.getInstance(); SimpleDateFormat SDF =新的SimpleDateFormat(“...
    编程 发布于2025-07-15

免责声明: 提供的所有资源部分来自互联网,如果有侵犯您的版权或其他权益,请说明详细缘由并提供版权或权益证明然后发到邮箱:[email protected] 我们会第一时间内为您处理。

Copyright© 2022 湘ICP备2022001581号-3