如何记录 web 错误

MDN Web 文档中的 JavaScript 错误参考是一个帮助 web 开发人员处理开发者工具中出现的错误的项目。对于该项目,我们需要在 MDN Web 文档中编写更多的错误文档,以便我们可以在抛出消息的工具中添加更多的链接。本文介绍了如何记录 web 错误。

JavaScript 错误会包含一个“了解更多”的链接,该链接会将你带到 JavaScript 错误参考,其中包含了修复问题的额外建议。为了能够记录 web 错误,你需要知道或能够深入了解 JavaScript

步骤 1——确定要记录的错误

步骤 2——查看现有的错误文档

  • 查看现有的 JavaScript 错误参考,了解如何记录错误。
  • 根据你想要记录的错误类型,你可以仔细查看这些页面。
  • 你可能会复制现有页面的内容来开始你新页面的记录。

步骤 3——创建新的错误页面

步骤 4——记录错误

  • 使用从现有错误文档中复制的结构,或者从头开始。由你决定!

  • 你应该至少包含:

    • 包含在不同浏览器中抛出的消息的语法框。
    • 错误类型。
    • 一段解释为什么会发生这种错误以及其后果的文本。应超越抛出的消息本身。
    • 展示错误的示例(可能不止一个!)以及展示如何修复代码的示例。
    • 指向 MDN Web 文档中其他参考资料的链接。

步骤 5——内容审查

在创建错误页面后,请将其以拉取请求的形式提交。会自动分配我们审查团队的成员来审查你的页面。