Heim  >  Artikel  >  Web-Frontend  >  Allgemeine Codierungsstandards JavaScript.

Allgemeine Codierungsstandards JavaScript.

王林
王林Original
2024-08-06 18:33:401165Durchsuche

General Coding Standards JavaScript.

Allgemeine Codierungsstandards

  1. Bedeutungsvolle Namen:
    • Verwenden Sie aussagekräftige und beschreibende Variablen- und Funktionsnamen.
    • Vermeiden Sie Abkürzungen und Namen mit nur einem Buchstaben, außer bei Schleifenzählern.
   // Good
   const userAge = 25;
   function calculateTotalPrice(items) { ... }

   // Bad
   const a = 25;
   function calc(items) { ... }
  1. Konsistente Namenskonventionen:
    • Verwenden Sie camelCase für Variablen und Funktionen.
    • Verwenden Sie PascalCase für Klassennamen.
   const userAge = 25;
   function calculateTotalPrice(items) { ... }
   class UserProfile { ... }
  1. Wiederholungen vermeiden:
    • Folgen Sie dem DRY-Prinzip (Don't Repeat Yourself), indem Sie wiederholten Code in Funktionen kapseln.
   // Good
   function calculateDiscount(price, discount) { ... }
   const price1 = calculateDiscount(100, 10);
   const price2 = calculateDiscount(200, 20);

   // Bad
   const price1 = 100 - 10;
   const price2 = 200 - 20;
  1. Fehlerbehandlung:
    • API-Aufrufe und andere asynchrone Vorgänge in Try-Catch-Blöcken einschließen.
   async function fetchData() {
     try {
       const response = await fetch('api/url');
       const data = await response.json();
       return data;
     } catch (error) {
       console.error('Error fetching data:', error);
     }
   }
  1. Edge Cases:
    • Berücksichtigen Sie immer Grenzfälle und validieren Sie Eingaben.
   function getUserAge(user) {
     if (!user || !user.age) {
       return 'Age not available';
     }
     return user.age;
   }
  1. Konsistente Formatierung:
    • Folgen Sie einem einheitlichen Code-Formatierungsstil (Einrückung, Abstand usw.). Verwenden Sie Tools wie Prettier, um dies zu automatisieren.
   if (condition) {
     doSomething();
   } else {
     doSomethingElse();
   }

Code-Organisation

  1. Modularisierung:
    • Teilen Sie den Code in kleine, wiederverwendbare Module oder Funktionen auf.
   // utils.js
   export function calculateDiscount(price, discount) { ... }

   // main.js
   import { calculateDiscount } from './utils.js';
  1. Trennung der Belange:
    • Unterteilen Sie verschiedene Belange (z. B. UI-Logik, Geschäftslogik, Datenverarbeitung) in verschiedene Dateien oder Funktionen.
   // ui.js
   function updateUI(data) { ... }

   // data.js
   async function fetchData() { ... }

   // main.js
   import { updateUI } from './ui.js';
   import { fetchData } from './data.js';

Best Practices

  1. Strikten Modus verwenden:
    • Aktivieren Sie immer den strikten Modus, um häufige Codierungsfehler zu erkennen.
   'use strict';
  1. Konstanten verwenden:
    • Verwenden Sie Konstanten für Werte, die sich nicht ändern.
   const MAX_USERS = 100;
  1. Globale Variablen vermeiden:
    • Minimieren Sie die Verwendung globaler Variablen, um Konflikte und unbeabsichtigtes Verhalten zu vermeiden.
   // Good
   (function() {
     const localVariable = 'This is local';
   })();

   // Bad
   var globalVariable = 'This is global';
  1. Kommentieren und Dokumentation:
    • Schreiben Sie Kommentare und Dokumentationen, um den Zweck und die Funktionalität des Codes zu erläutern.
   /**
    * Calculates the total price after applying a discount.
    * @param {number} price - The original price.
    * @param {number} discount - The discount to apply.
    * @returns {number} - The total price after discount.
    */
   function calculateTotalPrice(price, discount) { ... }
  1. Versprechen und Async/Await mit Fehlerbehandlung verwenden:
    • Bevorzugen Sie die Verwendung von Promises und async/await für asynchrone Vorgänge und packen Sie sie zur Fehlerbehandlung in Try-Catch-Blöcke ein.
   // Good
   async function fetchData() {
     try {
       const response = await fetch('api/url');
       const data = await response.json();
       return data;
     } catch (error) {
       console.error('Error fetching data:', error);
     }
   }

   // Bad
   function fetchData(callback) {
     fetch('api/url')
       .then(response => response.json())
       .then(data => callback(data))
       .catch(error => console.error('Error fetching data:', error));
   }
  1. Objektzerstörung:
    • Verwenden Sie die Objektdestrukturierung, um mehrere Eigenschaften eines Objekts auf prägnante Weise zu extrahieren.
   // Good
   const vehicle = { make: 'Toyota', model: 'Camry' };
   const { make, model } = vehicle;

   // Bad
   const vehicleMake = vehicle.make;
   const vehicleModel = vehicle.model;

Durch die Einhaltung dieser Standards können Sie sicherstellen, dass Ihr JavaScript-Code sauber, wartbar und effizient ist.

Das obige ist der detaillierte Inhalt vonAllgemeine Codierungsstandards JavaScript.. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!

Stellungnahme:
Der Inhalt dieses Artikels wird freiwillig von Internetnutzern beigesteuert und das Urheberrecht liegt beim ursprünglichen Autor. Diese Website übernimmt keine entsprechende rechtliche Verantwortung. Wenn Sie Inhalte finden, bei denen der Verdacht eines Plagiats oder einer Rechtsverletzung besteht, wenden Sie sich bitte an admin@php.cn