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>
Nach dem Login kopieren
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
Nach dem Login kopieren
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 {};
Nach dem Login kopieren
Fügen Sie es in Ihre index.html ein:
<script type="module" src="./index.js"></script>
Nach dem Login kopieren
Ö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";
Nach dem Login kopieren
oder für ihre Exporte
import { add, multiply } "./my-math-lib.js";
Nach dem Login kopieren
Ziemlich cool, oder? Weitere Informationen finden Sie im MDN-Leitfaden oben.
Pakete
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";
Nach dem Login kopieren
Wer auf Nummer sicher gehen möchte, kann Versionen pinnen.
Typen
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
Nach dem Login kopieren
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"]
}
Nach dem Login kopieren
Jetzt ausführen
npm run tsc --watch -p jsconfig.json
Nach dem Login kopieren
und machen Sie einen Typfehler in Ihrem Code. Der TypeScript-Compiler sollte sich beschweren:
/** @type {number} **/
const num = "hello";
Nach dem Login kopieren
Ü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.
Karten importieren
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>
Nach dem Login kopieren
Jetzt können wir dieses Paket einfach mit
importieren
import {} from "superstruct"
Nach dem Login kopieren
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
Nach dem Login kopieren
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/",
Nach dem Login kopieren
Zu meiner Importkarte. Dann kann jedes über esm.sh verfügbare Projekt durch einfaches Importieren verwendet werden. Z.B.:
import Peer from "cdn/peerjs";
Nach dem Login kopieren
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/*"]
},
Nach dem Login kopieren
Einsatz
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.
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);
}
Nach dem Login kopieren
Now create a file example.test.js.
import { test, assert } from "@/test.js";
test("1+1", () => {
assert(1 + 1 === 2);
});
Nach dem Login kopieren
And a file where you import all your tests:
import "./example.test.js";
console.log("This should only show up when running tests");
Nach dem Login kopieren
Run this on page load:
await import("@/test/index.js"); // file that imports all tests
(await import("@/test.js")).runAllTests();
Nach dem Login kopieren
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.
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!
