API目录
JavaScript API 打印

核心JavaScript参考

核心JavaScript参考记载了JavaScript核心语言定义的类,方法和属性。

这部分文档所包括的类和对象有:

Arguments Error JavaClass Object
Array Math JavaObject RegExp
Boolean Global JavaPackage String
Date JavaArray Number Function
示例条目
可用性
如何阅读JavaScript核心参考手册
从......继承

标题和简述

每个参考条目的标题由四部分组成,如上所示。各个条目按照标题的字母顺序排列。标题行下的简短描述说明了该条目中记叙的项目,它可以帮助你快速地判断是否对该参考余下部分感兴趣。

可用性

标题右上角是可用性信息在本书中,这些信息告诉你该项目等到了哪些Web浏览器的什么版本的支持。今天,大多数浏览器都支持这里列出的项目,这个可用性部分会告诉你什么标准为该项目提供了正式规范。例如,你可能会在这里看到“ECMAScript v1”或“ECMAScript v2”。如果该项目已经不再使用了,也会在这里提示。
浏览器的名称和版本号有时候也会出现在这里,通常所介绍的项目还是较新兴的功能,并没有被广泛采用,或者该项目是特定于IE的功能。
如果一个项目还没有标准化但是在支持JavaScript的版本号。例如,History对象,其可访问性为“JavaScript 1.0”
如果一个方法的条目没有包含任何可用性信息,这意味着它和定义该方法的类都有着同样的可访问性。

从......继承/覆盖

如果一个类继承了超类,可一个方法覆盖了超类中的方法,该信息将显示在标题的右下角。例如,String类继承Object类,HTMLDocument类继承Document类,Document类继承了Node类。String的条目就把这一继承概括为“Object->String”,而HTMLDocument的条目则表示为“Node->Document->HTMLDocument”。在看到这些继承信息时,便可以查询列出的超类的信息。
当一个方法与超类中的方法同名时,该方法覆盖超类的方法。

构造函数

如果参考中介绍一个类且这个类有构造函数,通常用“构造函数”部分来说明如何使用构造方法创建类的实例。由于构造函数是一种方法,因此“构造函数”部分与方法参考中的“摘要”部分看起来很象。

摘要

函数,方法和属性的参考都有“摘要“部分,该部分展示了如何在代码中使用这些函数,方法和属性。本API中的参考条目使用两种不同的风格的摘要。核心JavaScript参考中的条目和客户端条目使用不带类型的摘要来介绍和DOM不相关的方法(如Window方法)。例如,Array.concat()方法的摘要如下:
    array.concat(value,...)
斜体字说明要替换的文本。array应该用变量或存放数组且计算数组值的表达式来替换。value只是要传递给方法的一个参数的名称。这个指定的参数稍后会在摘要中描述,并且这个描述包含了有关参数的类型和作用的信息。省略号(...)说明该方法可以有任意多个value参数。因为concat和开括号及闭括号不是以斜体显示的,所以在JavaScript代码中,必须完全采用它们。
客户端JavaScript部分介绍的很多方法都是被W3C标准化了的,它们的规范包含了方法参数和返回值的明确的类型信息。这些条目把这些类型信息包含在摘要里。例如,Document.getElementById()方法的摘要如下:
    Element.getElementById(String elementId);
这个摘要使用Java语法来表明getElementById()返回一个Element对象并且期待一个名为elementId的字符串参数。由于这是Document的一个方法,它隐式地在一个文档上调用,但并不包括document前缀。

参考

如果参考描述的函数,方法或类具有构造函数方法,那么“构造函数”,或“摘要”后还有“参数”部分,说明这个函数,方法或构造的参数。如果没有参数,这个部分将被省略。
    arg1
参数部分中的参数用一个列表描述。例如,这就是对参数arg1的描述。
    arg2
这是对参数arg2的描述。

返回值

如果函数或方法具有返回值,就用这一部分来说明它们的返回值

抛出

如果构造函数,函数或方法可以抛出异常,这一部分列出了可能被抛出的异常类型,并解释了在什么环境下会抛出异常。

常量

有些类定义了一组常量,作为一个属性的值或者作为一个方法的参数。例如,Node接口富庶了重要的常量来充当其nodeType属性的一组合法值。当一个接口定义了常量,本部分会列出并介绍它们。注意,这些常量是类自身的静态属性,而不是类的实例的属性。

属性

如果参考API中说明这是一个类,“属性”部分就会列出这个类定义的属性并且对每个属性进行简短的解释。每个属性还有自己的参考API。和DOM相关的类的属性包含了类型信息。
属性列表如下:
prop1
    这是无类型的属性prop1的概述。上面只是列出了属性名,但这个描述会告诉你属性的类型,作用以及它是只读还是可读可写的。
readonly integer prop2
    这是一个有类型的属性prop2。属性名和它的类型一起出现。这个描述性的段落说明了该属性的作用。

方法

如果一个类定义了方法,那么它的参考中就具有“方法”部分。这一部分与“属性”部分相似,只不过它说明的是方法而不是属性。所有方法还具有自己的参考。这个概括部分中是提供方法名的列表。参数类型和返回值类型信息可以在方法的圣者中找到。

描述

大多数参考都具有“描述”部分,该部分说明的类,方法,函数或属性进行了描述。它是参考的核心作用。

例子

有些参考还包括一个例子,该例子展示了该项目的习惯用法。

Bugs

当一个项目不能正常运行时,这一部分描述了导致这种现象的bug。但要注意,这里不可能列出所有JavaScript版本和实现中的每一个bug。

参阅

许多参考的结尾都包含相关的参考信息。

Comments
全部API
Friend Connect
Google AdSense
W3C Validation

Valid CSS!Valid XHTML 1.0 Transitional!