Wenn wir ein neues Webprojekt starten, bei dem JavaScript verwendet wird, richten wir oft als Erstes Build- und Entwicklertools ein. Zum Beispiel Vite, das heutzutage sehr beliebt ist. Möglicherweise wissen Sie nicht, dass komplizierte Build-Tools nicht für alle JavaScript-(Web-)Projekte erforderlich sind. Tatsächlich ist es jetzt einfacher als je zuvor, darauf zu verzichten, wie ich in diesem Artikel zeigen werde.
Erstellen Sie ein neues Projekt mit einer index.html-Datei.
<!doctype html>
<html>
<head>
</head>
<body>
<p>Hello world</p>
</body>
</html>
Wenn Sie VS Code verwenden, installieren Sie die Live Preview-Erweiterung. Führen Sie es aus. Dies ist ein einfacher Dateiserver mit Live-Reload. Sie können jeden Dateiserver verwenden. Python verfügt über einen integrierten:
python3 -m http.server
Ich mag die Live-Vorschau, weil sie die Seite automatisch aktualisiert, nachdem Änderungen an einer Datei vorgenommen wurden.
Sie sollten jetzt über den Browser auf Ihre index.html-Datei zugreifen können und „Hallo Welt“ sehen.
Als nächstes erstellen Sie eine index.js-Datei:
console.log("Hello world");
export {};
Fügen Sie es in Ihre index.html ein:
<script type="module" src="./index.js"></script>
Öffnen Sie die Entwicklerkonsole in Ihrem Browser. Wenn Sie „Hallo Welt“ sehen, wissen Sie, dass es ordnungsgemäß geladen wird.
Browser unterstützen jetzt ECMAScript-Module. Sie können andere Dateien aufgrund ihrer Nebenwirkungen importieren:
import "./some-other-script.js";
oder für ihre Exporte
import { add, multiply } "./my-math-lib.js";
Ziemlich cool, oder? Weitere Informationen finden Sie im MDN-Leitfaden oben.
Sie möchten das Rad wahrscheinlich nicht neu erfinden, daher wird Ihr Projekt wahrscheinlich einige Pakete von Drittanbietern verwenden. Das bedeutet nicht, dass Sie jetzt einen Paketmanager verwenden müssen.
Angenommen, wir möchten Superstruct zur Datenvalidierung verwenden. Wir können Module nicht nur von unserem eigenen (lokalen) Dateiserver laden, sondern von jeder URL. esm.sh stellt bequem Module für fast alle auf npm verfügbaren Pakete bereit.
Wenn Sie https://esm.sh/superstruct besuchen, können Sie sehen, dass Sie zur neuesten Version weitergeleitet werden. Sie können dieses Paket wie folgt in Ihren Code einbinden:
import { assert } from "https://esm.sh/superstruct";
Wer auf Nummer sicher gehen möchte, kann Versionen pinnen.
Ich weiß nicht, wie es Ihnen geht, aber TypeScript hat mich verwöhnt (und faul gemacht). Das Schreiben von einfachem JavaScript ohne die Hilfe des Typprüfers fühlt sich an, als würde man auf einem Drahtseil schreiben. Zum Glück müssen wir auch nicht auf die Typprüfung verzichten.
Es ist an der Zeit, npm auszumerzen (auch wenn wir keinen Code versenden, den es bereitstellt).
npm init --yes npm install typescript
Sie können den TypeScript-Compiler problemlos für JavaScript-Code verwenden! Dafür gibt es erstklassigen Support. Erstellen Sie eine jsconfig.json:
{
"compilerOptions": {
"strict": true,
"checkJs": true,
"allowJs": true,
"noImplicitAny": true,
"lib": ["ES2022", "DOM"],
"module": "ES2022",
"target": "ES2022"
},
"include": ["**/*.js"],
"exclude": ["node_modules"]
}
Jetzt ausführen
npm run tsc --watch -p jsconfig.json
und machen Sie einen Typfehler in Ihrem Code. Der TypeScript-Compiler sollte sich beschweren:
/** @type {number} **/
const num = "hello";
Übrigens ist der Kommentar, den Sie oben sehen, JSDoc. Auf diese Weise können Sie Ihr JavaScript mit Typen annotieren. Es ist zwar etwas ausführlicher als die Verwendung von TypeScript und man gewöhnt sich ziemlich schnell daran. Es ist auch sehr leistungsfähig, solange Sie keine verrückten Typen schreiben (was Sie bei den meisten Projekten nicht tun sollten), sollte alles in Ordnung sein.
Wenn Sie einen komplizierten Typ (Helfer) benötigen, können Sie jederzeit etwas TypeScript in eine .d.ts-Datei hinzufügen.
Ist JSDoc nur ein Sprungbrett für Leute, die mit großen JavaScript-Projekten festsitzen, um schrittweise auf TypeScript migrieren zu können? Das glaube ich nicht! Das TypeScript-Team fügt außerdem weiterhin großartige Funktionen zu JSDoc + TypeScript hinzu, beispielsweise in der kommenden TypeScript-Version. Die automatische Vervollständigung funktioniert auch in VS Code hervorragend.
Wir haben gelernt, wie wir ohne Build-Tool externe Pakete zu unserem Projekt hinzufügen können. Wenn Sie Ihren Code jedoch in viele Module aufteilen, kann das wiederholte Ausschreiben der vollständigen URL etwas ausführlich sein.
Wir können dem Kopfbereich unserer index.html eine Importkarte hinzufügen:
<script type="importmap">
{
"imports": {
"superstruct": "https://esm.sh/superstruct@1.0.4"
}
}
</script>
Jetzt können wir dieses Paket einfach mit
importieren
import {} from "superstruct"
Wie ein „normales“ Projekt. Ein weiterer Vorteil besteht darin, dass die Vervollständigung und Erkennung von Typen wie erwartet funktioniert, wenn Sie das Paket lokal installieren.
npm install --save-dev superstruct
Beachten Sie, dass die Version in Ihrem node_modules-Verzeichnis nicht verwendet wird. Sie können es entfernen und Ihr Projekt wird weiter ausgeführt.
Ein Trick, den ich gerne verwende, ist das Hinzufügen von:
"cdn/": "https://esm.sh/",
Zu meiner Importkarte. Dann kann jedes über esm.sh verfügbare Projekt durch einfaches Importieren verwendet werden. Z.B.:
import Peer from "cdn/peerjs";
Wenn Sie für die Entwicklung auch für diesen Importtyp Typen aus node_modules abrufen möchten, müssen Sie Folgendes zu den „compilerOptions“ Ihrer jsconfig.json hinzufügen:
"paths": {
"cdn/*": ["./node_modules/*", "./node_modules/@types/*"]
},
Um Ihr Projekt bereitzustellen, kopieren Sie alle Dateien auf einen statischen Dateihost und schon sind Sie fertig! Wenn Sie jemals an einem älteren JavaScript-Projekt gearbeitet haben, wissen Sie, wie schmerzhaft es ist, Build-Tools zu aktualisieren, die noch nicht einmal ein bis zwei Jahre alt sind. Mit diesem Projektaufbau wird Ihnen nicht das gleiche Schicksal widerfahren.
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.
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.
Das obige ist der detaillierte Inhalt vonWebentwicklung ohne (Build-)Tools. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!
![[Web-Frontend] Node.js-Schnellstart](https://img.php.cn/upload/course/000/000/067/662b5d34ba7c0227.png)
