Komentari u JavaScript-u

• Travanj 28, 2024

Komentari su upravo to, komentari koje unesete u svoj JavaScript ili HTML kako biste objasnili što se događa. Postoji nekoliko načina za dodavanje komentara u JavaScript kod. Sintaksa komentara - kako reći skripti ili dokumentu da je nešto komentar, a ne podatak ili kod - vrlo je jednostavno. Teže je pisati dobre komentare, a od gledanja koda (uključujući i moj), čini se da je najteži dio zapravo!

JavaScript sadrži dvije vrste komentara, komentar s jednom linijom i komentar s više redaka.

Komentar jednog retka u JavaScriptu započinje s dvije crte naprijed (//) i završava na kraju retka (tehnički neposredno prije znaka terminara linije). Komentari s jednom linijom osobito su korisni za kratke bilješke.

// Ovo je komentar u jednoj liniji
data = "moji podaci" // Ovo je i komentar u jednom retku

Komentar s više redaka u JavaScriptu započinje kosom naprijed, a zatim zvjezdicom (/*) i završava zvjezdicom nakon koje slijedi kosina prema naprijed (*/). Sve između /* i */ smatra se komentarom. Ova vrsta komentara može obuhvaćati više redaka. Također je moguće staviti ovu vrstu komentara na sredinu retka koda, ako se on ne proteže u više redaka, ali to je rijetko korisno.

/ * ovo je prvi redak komentara s više redaka
to je još uvijek dio mog komentara
ovo je zadnji dio mog komentara * /

/ * ovo je komentar u više redaka u jednom retku * /

Često vidite dodatne zvjezdice dodane u komentare s više linija radi stvaranja ukrasnih informativnih okvira, poput:

/*********************
* Moje funkcije *
*********************/

Višenamjenske funkcije osobito su korisne na početku programa ili odjeljka programa kako biste opisali što program namjerava raditi i kako to čini.

Komentari se koriste u dvije svrhe. Dok pišete kôd (ili čak i prije nego što ga napišete!), Trebali biste napisati komentare koji će omogućiti drugoj osobi da shvati što program radi (ili bi trebao raditi.) Čak i ako ne očekujete da će ga itko ikad pročitati vaš kôd, iznenadit ćete se koliko možete zaboraviti ako želite unijeti promjene nakon nekoliko tjedana ili mjeseci.

Također, posebno u jezicima skriptiranja kao što je JavaScript, komentari se često koriste kao dio postupka uklanjanja pogrešaka. Možete staviti kôd koji će se koristiti za uklanjanje pogrešaka i komentirati ih kad završite s njima ili komentirati dijelove koda za koje smatrate da uzrokuju probleme ili se mijenjaju da bi dodali novu funkcionalnost. Kad to učinite, budite posebno oprezni da ne stavite komentar s jednim retkom ispred početka komentara s više redova. To komentira ostatak komentara s više redaka, što će gotovo sigurno uzrokovati pogrešku.

Upute Video: JavaScript Tutorijali - 5 - Komentari (Travanj 2024).