Q:如何在程式碼中插入註解?
A:JavaScript 支援三種形式。
第一種是 C 語言風格的多行註解,包在 /* 與 */ 之間,可跨任意行數:
/* This is a comment */
/* C-style comments can span
as many lines as you like,
as shown in this example */
第二種是 C++ 風格的單行註解,從 // 開始到行尾結束:
// This is a one-line comment
第三種是以 HTML 註解起始序列 <!-- 引導的單行註解。要注意 JavaScript 直譯器會忽略 HTML 註解的結束字元 -->,因此:
<!-- This is treated as a one-line JS comment
<!-- It works just like a comment beginning with //
<!-- --> This is also a one-line JS comment
<!-- --> because JS ignores the closing characters
<!-- --> of HTML-style comments
HTML 風格註解在實際程式碼中並不常見(// 更簡潔易讀),但下一題會說明它為何仍值得知道。
Q:如何讓不支援 JavaScript 的舊瀏覽器不要顯示出程式碼?
A:做法是「開頭用 HTML 註解開啟、結尾用 JS 註解關閉」。腳本的開頭兩行寫成:
<script language="JavaScript">
<!--
結尾兩行則是:
//-->
</script>
組合起來:
<script language="JavaScript">
<!--
Here you put your JS code.
Old browsers will treat it
as an HTML comment.
//-->
</script>
原理很巧妙:舊瀏覽器不認識 <script>,會把整段內容當成一段漫長的 HTML 註解而不顯示;支援 JavaScript 的瀏覽器則正常執行中間的程式碼,同時把首末兩行視為單行註解而跳過。兩邊都過得去。
Q:若使用者瀏覽器無法執行 JavaScript,我能給個警告嗎?
A:把提示放在 <NOSCRIPT> 與 </NOSCRIPT> 之間即可:
<NOSCRIPT>
<H3>This page uses JavaScript</H3>
<ul>
<li>Please use Netscape Navigator 3+ or Internet Explorer 3+
<li>Make sure that JavaScript is enabled in your browser.
</ul>
</NOSCRIPT>
支援 JavaScript 的瀏覽器會直接忽略這段內容;不支援的則會把它顯示出來。
注意:Netscape Navigator 2 並不支援 <NOSCRIPT>,因此這段訊息對使用 Netscape 2 的人一律可見。撰寫文案時記得這一點,別誤導了他們——上例的措辭假設腳本需要至少 3 版瀏覽器。
Q:可以從外部引入 JS 檔,而不把全部腳本塞在 HTML 裡嗎?
A:可以。建立一個副檔名為 .js 的檔案,例如 myscript.js,把程式碼放進去。注意不要在 .js 檔裡寫 <script> 或 </script> 標籤。
嵌入方式:
<SCRIPT LANGUAGE="JavaScript" SRC="myscript.js">
</SCRIPT>
這麼做最大的好處是可重用:把常用函數集中在 .js 檔中,多個頁面都能引用同一份,修改時也只需改一處。缺點是極舊的瀏覽器(如 Navigator 2.x、Explorer 3.x)不會載入外部 JavaScript 檔。
Q:JavaScript 有哪些保留字?
A:以下字樣一律不可作為識別字使用。其中部分已在語言中使用,部分則是為相容性或未來擴充而保留:
abstract else instanceof switch
boolean enum int synchronized
break export interface this
byte extends long throw
case false native throws
catch final new transient
char finally null true
class float package try
const for private typeof
continue function protected var
debugger goto public void
default if return volatile
delete implements short while
do import static with
double in super
除了這批硬性保留字,實務上還建議避開以下識別字。它們是 Netscape Navigator 或 Internet Explorer 中的用戶端物件、方法或屬性名稱,用來當變數名容易引發混淆與錯誤:
alert hidden outerWidth
all history packages
anchor image pageXOffset
anchors images pageYOffset
area isNaN parent
array java parseFloat
assign JavaArray parseInt
blur JavaClass password
button JavaObject pkcs11
checkbox JavaPackage plugin
clearTimeout innerHeight prompt
clientInformation innerWidth prototype
close layer radio
closed layers reset
confirm length screenX
crypto link screenY
date location scroll
defaultStatus Math secure
document mimeTypes select
element name self
elements navigate setTimeout
embed navigator status
embeds netscape String
escape Number submit
eval Object sun
event offscreenBuffering taint
fileUpload onblur text
focus onerror textarea
form onfocus top
forms onload toString
frame onunload unescape
frames open untaint
frameRate opener valueOf
function option window
getClass outerHeight
實務上的建議是:變數命名尽量加上語意化的前綴或使用 camelCase,就能自然避開絕大部分衝突。若真的不確定,寫入前先 console.log(typeof yourName) 確認一下,比事後除錯划算得多。