首页 web前端 js教程 无需(构建)工具的 Web 开发

无需(构建)工具的 Web 开发

Aug 05, 2024 pm 07:11 PM

Web Development Without (Build) Tooling

当启动一个将使用 JavaScript 的新 Web 项目时,我们做的第一件事通常是设置构建和开发人员工具。比如现在很流行的Vite。您可能不知道并非所有 JavaScript(Web)项目都需要复杂的构建工具。事实上,正如我将在本文中展示的那样,现在比以往任何时候都更容易摆脱困境。

使用index.html 文件创建一个新项目。

<!doctype html>
<html>
  <head>
  </head>
  <body>
    <p>Hello world</p>
  </body>
</html>
登录后复制

如果您使用的是 VS Code,请安装实时预览扩展。运行它。这是一个具有实时重新加载功能的简单文件服务器。您可以使用任何文件服务器,Python 内置了一个:

python3 -m http.server
登录后复制

我喜欢实时预览,因为它会在更改文件后自动刷新页面。

您现在应该能够从浏览器访问您的index.html 文件并看到“Hello world”。

接下来,创建一个index.js文件:

console.log("Hello world");

export {};
登录后复制

将其包含在您的index.html中:

<script type="module" src="./index.js"></script>
登录后复制

在浏览器中打开开发者控制台。如果您看到“Hello world”,则说明它正在正确加载。

浏览器现在支持 ECMAScript 模块。您可以导入其他文件以消除其副作用:

import "./some-other-script.js";
登录后复制

或用于出口

import { add, multiply } "./my-math-lib.js";
登录后复制

很酷吧?请参阅上面的 MDN 指南了解更多信息。

套餐

您可能不想重新发明轮子,因此您的项目可能会使用一些第三方包。这并不意味着您现在需要开始使用包管理器。

假设我们想使用超级结构进行数据验证。我们不仅可以从我们自己的(本地)文件服务器加载模块,还可以从任何 URL 加载模块。 esm.sh 方便地为 npm 上可用的几乎所有包提供模块。

当您访问 https://esm.sh/superstruct 时,您可以看到您被重定向到最新版本。您可以在代码中包含此包,如下所示:

import { assert } from "https://esm.sh/superstruct";
登录后复制

如果您想安全起见,您可以固定版本。

类型

我不了解你,但 TypeScript 宠坏了我(并且让我变得懒惰)。在没有类型检查器帮助的情况下编写纯 JavaScript 感觉就像走钢丝一样。幸运的是,我们也不必放弃类型检查。

是时候淘汰 npm 了(尽管我们不会发布它提供的任何代码)。

npm init --yes
npm install typescript
登录后复制

您可以在 JavaScript 代码上使用 TypeScript 编译器!它有一流的支持。创建 jsconfig.json:

{
  "compilerOptions": {
    "strict": true,
    "checkJs": true,
    "allowJs": true,
    "noImplicitAny": true,
    "lib": ["ES2022", "DOM"],
    "module": "ES2022",
    "target": "ES2022"
  },
  "include": ["**/*.js"],
  "exclude": ["node_modules"]
}
登录后复制

现在运行

npm run tsc --watch -p jsconfig.json
登录后复制

并在代码中犯一个类型错误。 TypeScript 编译器应该抱怨:

/** @type {number} **/
const num = "hello";
登录后复制

顺便说一下,你上面看到的评论是 JSDoc。您可以通过这种方式用类型注释您的 JavaScript。虽然它比使用 TypeScript 更冗长一些,但你很快就会习惯它。它也非常强大,只要您不编写疯狂的类型(对于大多数项目来说您不应该这样做),您应该没问题。

如果您确实需要复杂的类型(助手),您可以随时在 .d.ts 文件中添加一些 TypeScript。

JSDoc 是否只是那些陷入大型 JavaScript 项目的人们能够逐步迁移到 TypeScript 的垫脚石?我不这么认为! TypeScript 团队还继续向 JSDoc + TypeScript 添加出色的功能,例如即将发布的 TypeScript 版本。自动完成功能在 VS Code 中也非常有效。

导入地图

我们学习了如何在不使用构建工具的情况下将外部包添加到我们的项目中。但是,如果您将代码拆分为许多模块,则一遍又一遍地写出完整的 URL 可能会有点冗长。

我们可以将导入映射添加到我们的index.html的head部分:

<script type="importmap">
  {
    "imports": {
      "superstruct": "https://esm.sh/superstruct@1.0.4"
    }
  }
</script>
登录后复制

现在我们可以简单地使用
导入这个包

import {} from "superstruct"
登录后复制

就像一个“正常”项目。另一个好处是,如果您在本地安装该软件包,类型的完成和识别将按预期工作。

npm install --save-dev superstruct
登录后复制

请注意,node_modules 目录中的版本将不会被使用。您可以将其删除,您的项目将继续运行。

我喜欢使用的一个技巧是添加:

      "cdn/": "https://esm.sh/",
登录后复制

到我的导入地图。然后,通过 esm.sh 提供的任何项目都可以通过简单地导入来使用。例如:

import Peer from "cdn/peerjs";
登录后复制

如果您也想从node_modules中提取类型以进行此类导入的开发,则需要将以下内容添加到jsconfig.json的compilerOptions中:

    "paths": {
      "cdn/*": ["./node_modules/*", "./node_modules/@types/*"]
    },
登录后复制

部署

要部署您的项目,请将所有文件复制到静态文件主机,然后就完成了!如果您曾经参与过旧版 JavaScript 项目,您就会知道更新不到 1-2 年的构建工具的痛苦。通过此项目设置,您将不会遭受同样的命运。

Testing

If your JavaScript does not depend on browser APIs, you could just use the test runner that comes bundled with Node.js. But why not write your own test runner that runs right in the browser?

/** @type {[string, () => Promise<void> | void][]} */
const tests = [];

/**
 *
 * @param {string} description
 * @param {() => Promise<void> | void} testFunc
 */
export async function test(description, testFunc) {
  tests.push([description, testFunc]);
}

export async function runAllTests() {
  const main = document.querySelector("main");
  if (!(main instanceof HTMLElement)) throw new Error();
  main.innerHTML = "";

  for (const [description, testFunc] of tests) {
    const newSpan = document.createElement("p");

    try {
      await testFunc();
      newSpan.textContent = `✅ ${description}`;
    } catch (err) {
      const errorMessage =
        err instanceof Error && err.message ? ` - ${err.message}` : "";
      newSpan.textContent = `❌ ${description}${errorMessage}`;
    }
    main.appendChild(newSpan);
  }
}

/**
 * @param {any} val
 */
export function assert(val, message = "") {
  if (!val) throw new Error(message);
}
登录后复制

Now create a file example.test.js.

import { test, assert } from "@/test.js";

test("1+1", () => {
  assert(1 + 1 === 2);
});
登录后复制

And a file where you import all your tests:

import "./example.test.js";

console.log("This should only show up when running tests");
登录后复制

Run this on page load:

await import("@/test/index.js"); // file that imports all tests
(await import("@/test.js")).runAllTests();
登录后复制

And you got a perfect TDD setup. To run only a section of the tests you can comment out a few .test.js import, but test execution speed should only start to become a problem when you have accumulated a lot of tests.

Benefits

Why would you do this? Well, using fewer layers of abstraction makes your project easier to debug. There is also the credo to "use the platform". The skills you learn will transfer better to other projects. Another advantage is, when you return to a project built like this in 10 years, it will still just work and you don't need to do archeology to try to revive a build tool that has been defunct for 8 years. An experience many web developers that worked on legacy projects will be familiar with.

See plainvanillaweb.com for some more ideas.

以上是无需(构建)工具的 Web 开发的详细内容。更多信息请关注PHP中文网其他相关文章!

本站声明
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热AI工具

Undresser.AI Undress

Undresser.AI Undress

人工智能驱动的应用程序,用于创建逼真的裸体照片

AI Clothes Remover

AI Clothes Remover

用于从照片中去除衣服的在线人工智能工具。

Undress AI Tool

Undress AI Tool

免费脱衣服图片

Clothoff.io

Clothoff.io

AI脱衣机

Video Face Swap

Video Face Swap

使用我们完全免费的人工智能换脸工具轻松在任何视频中换脸!

热门文章

<🎜>:泡泡胶模拟器无穷大 - 如何获取和使用皇家钥匙
4 周前 By 尊渡假赌尊渡假赌尊渡假赌
北端:融合系统,解释
4 周前 By 尊渡假赌尊渡假赌尊渡假赌
Mandragora:巫婆树的耳语 - 如何解锁抓钩
3 周前 By 尊渡假赌尊渡假赌尊渡假赌

热工具

记事本++7.3.1

记事本++7.3.1

好用且免费的代码编辑器

SublimeText3汉化版

SublimeText3汉化版

中文版,非常好用

禅工作室 13.0.1

禅工作室 13.0.1

功能强大的PHP集成开发环境

Dreamweaver CS6

Dreamweaver CS6

视觉化网页开发工具

SublimeText3 Mac版

SublimeText3 Mac版

神级代码编辑软件(SublimeText3)

热门话题

Java教程
1671
14
CakePHP 教程
1428
52
Laravel 教程
1331
25
PHP教程
1276
29
C# 教程
1256
24
Python vs. JavaScript:学习曲线和易用性 Python vs. JavaScript:学习曲线和易用性 Apr 16, 2025 am 12:12 AM

Python更适合初学者,学习曲线平缓,语法简洁;JavaScript适合前端开发,学习曲线较陡,语法灵活。1.Python语法直观,适用于数据科学和后端开发。2.JavaScript灵活,广泛用于前端和服务器端编程。

从C/C到JavaScript:所有工作方式 从C/C到JavaScript:所有工作方式 Apr 14, 2025 am 12:05 AM

从C/C 转向JavaScript需要适应动态类型、垃圾回收和异步编程等特点。1)C/C 是静态类型语言,需手动管理内存,而JavaScript是动态类型,垃圾回收自动处理。2)C/C 需编译成机器码,JavaScript则为解释型语言。3)JavaScript引入闭包、原型链和Promise等概念,增强了灵活性和异步编程能力。

JavaScript和Web:核心功能和用例 JavaScript和Web:核心功能和用例 Apr 18, 2025 am 12:19 AM

JavaScript在Web开发中的主要用途包括客户端交互、表单验证和异步通信。1)通过DOM操作实现动态内容更新和用户交互;2)在用户提交数据前进行客户端验证,提高用户体验;3)通过AJAX技术实现与服务器的无刷新通信。

JavaScript在行动中:现实世界中的示例和项目 JavaScript在行动中:现实世界中的示例和项目 Apr 19, 2025 am 12:13 AM

JavaScript在现实世界中的应用包括前端和后端开发。1)通过构建TODO列表应用展示前端应用,涉及DOM操作和事件处理。2)通过Node.js和Express构建RESTfulAPI展示后端应用。

了解JavaScript引擎:实施详细信息 了解JavaScript引擎:实施详细信息 Apr 17, 2025 am 12:05 AM

理解JavaScript引擎内部工作原理对开发者重要,因为它能帮助编写更高效的代码并理解性能瓶颈和优化策略。1)引擎的工作流程包括解析、编译和执行三个阶段;2)执行过程中,引擎会进行动态优化,如内联缓存和隐藏类;3)最佳实践包括避免全局变量、优化循环、使用const和let,以及避免过度使用闭包。

Python vs. JavaScript:社区,图书馆和资源 Python vs. JavaScript:社区,图书馆和资源 Apr 15, 2025 am 12:16 AM

Python和JavaScript在社区、库和资源方面的对比各有优劣。1)Python社区友好,适合初学者,但前端开发资源不如JavaScript丰富。2)Python在数据科学和机器学习库方面强大,JavaScript则在前端开发库和框架上更胜一筹。3)两者的学习资源都丰富,但Python适合从官方文档开始,JavaScript则以MDNWebDocs为佳。选择应基于项目需求和个人兴趣。

Python vs. JavaScript:开发环境和工具 Python vs. JavaScript:开发环境和工具 Apr 26, 2025 am 12:09 AM

Python和JavaScript在开发环境上的选择都很重要。1)Python的开发环境包括PyCharm、JupyterNotebook和Anaconda,适合数据科学和快速原型开发。2)JavaScript的开发环境包括Node.js、VSCode和Webpack,适用于前端和后端开发。根据项目需求选择合适的工具可以提高开发效率和项目成功率。

C/C在JavaScript口译员和编译器中的作用 C/C在JavaScript口译员和编译器中的作用 Apr 20, 2025 am 12:01 AM

C和C 在JavaScript引擎中扮演了至关重要的角色,主要用于实现解释器和JIT编译器。 1)C 用于解析JavaScript源码并生成抽象语法树。 2)C 负责生成和执行字节码。 3)C 实现JIT编译器,在运行时优化和编译热点代码,显着提高JavaScript的执行效率。

See all articles