Naming convention
Le naming convention sono regole condivise per scegliere i nomi di variabili, funzioni, costanti, classi e file. In JavaScript non sono obbligatorie a livello di linguaggio, ma sono fondamentali per:
- rendere il codice leggibile
- evitare ambiguità
- facilitare il lavoro in team
- ridurre errori e bug
- migliorare la manutenzione nel tempo
Scrivere codice “che si legge come una frase” è una delle competenze principali di uno sviluppatore web professionista.
Perché sono così importanti
Un buon nome:
- spiega cosa fa una variabile o una funzione
- non richiede commenti per essere capito
- riduce il carico mentale di chi legge il codice
- previene bug logici causati da nomi fuorvianti
Confronta:
let x = 120;let maxUploadSize = 120;Il secondo esempio comunica immediatamente lo scopo della variabile.
Stili di scrittura più comuni
In JavaScript si utilizzano principalmente questi stili:
camelCase
Usato per:
- variabili
- funzioni
- metodi
let userName;
function getUserData() {}PascalCase
Usato per:
- classi
- costruttori
class UserProfile {}UPPER_SNAKE_CASE
Usato per:
- costanti globali
- valori che non devono mai cambiare
const API_URL = "https://api.example.com";kebab-case
Usato per:
- nomi di file
- nomi di cartelle
- attributi HTML personalizzati
user-service.js
main-layout.cssRegole generali
1. Usa nomi descrittivi
Evita nomi vaghi come data, temp, value.
// ❌
let d;
// ✅
let userBirthDate;2. Usa l’inglese
La community JavaScript usa l’inglese come standard.
// ❌
let nomeUtente;
// ✅
let userName;3. Non abbreviare senza motivo
// ❌
let usrNm;
// ✅
let userName;Le abbreviazioni sono accettabili solo se universalmente note (id, url, api).
4. Usa prefissi semantici per i booleani
I booleani dovrebbero sembrare una domanda.
let isLoggedIn;
let hasPermission;
let canEdit;5. Funzioni = verbi
Le funzioni dovrebbero descrivere un’azione.
function calculateTotal() {}
function fetchUsers() {}
function saveSettings() {}6. Array e collezioni al plurale
let users = [];
let orders = [];7. Evita nomi troppo generici
// ❌
let data;
let result;
// ✅
let userList;
let totalPrice;8. Mantieni coerenza
Scegli uno stile e usalo ovunque.
// ❌
let user_name;
let userName;
// ✅
let userName;Convenzioni per casi comuni
Callback
function handleClick() {}
function onSubmit() {}Funzioni asincrone
async function fetchProducts() {}Eventi
function handleResize() {}
function onLoginSuccess() {}File
auth-service.js
user-controller.js
product.model.jsErrori comuni da evitare
- usare una sola lettera (
x,y) - usare numeri nel nome (
data1,value2) - mescolare lingue diverse
- usare nomi troppo lunghi
- usare nomi che non riflettono più il comportamento reale
Obiettivo finale
Una buona naming convention permette di:
- leggere il codice senza commenti
- capire il flusso logico a colpo d’occhio
- rendere il progetto scalabile
- ridurre il tempo di onboarding di nuovi sviluppatori
Un buon nome è una forma di documentazione.