JavaScript 域

在版本 1.0 中添加。

JavaScript 域（名称 js）提供以下指令

.. js:module:: name

此指令设置后续对象声明的模块名称。模块名称用于全局模块索引和交叉引用。此指令不会像 py:class 指令那样创建对象标题，例如。

默认情况下，此指令将创建一个可链接的实体，并在全局模块索引中创建一个条目，除非指定了 no-index 选项。如果指定了此选项，则该指令将仅更新当前模块名称。

在版本 1.6 中添加。

在版本 5.2 中更改：模块指令支持正文内容。

.. js:function:: name(signature)

描述一个 JavaScript 函数或方法。 如果你想将参数描述为可选的，请使用方括号，如 Python 签名的 文档 中所述。

你可以使用字段来提供关于参数及其预期类型、函数可能抛出的错误以及返回值的更多详细信息

.. js:function:: $.getJSON(href, callback[, errback])

   :param string href: An URI to the location of the resource.
   :param callback: Gets called with the object.
   :param errback:
       Gets called in case the request fails. And a lot of other
       text so we need multiple lines.
   :throws SomeError: For whatever reason in that case.
   :returns: Something.

这将呈现为

$.getJSON(href, callback[, errback])
参数:

  • href (string()) – 资源位置的 URI。

  • callback – 使用对象调用。

  • errback – 在请求失败的情况下调用。 以及很多其他文本，所以我们需要多行。

抛出:

SomeError() – 在该情况下，无论何种原因。

返回:

一些内容。

:single-line-parameter-list: (no value)

确保函数的参数将在单行逻辑行上发出，覆盖 javascript_maximum_signature_line_length 和 maximum_signature_line_length。

在版本 7.1 中添加。

.. js:method:: name(signature)

此指令是 js:function 的别名，但它描述的是作为类对象方法实现的函数。

在版本 1.6 中添加。

:single-line-parameter-list: (no value)

确保函数的参数将在单行逻辑行上发出，覆盖 javascript_maximum_signature_line_length 和 maximum_signature_line_length。

在版本 7.1 中添加。

.. js:class:: name

描述一个创建对象的构造函数。 这基本上类似于一个函数，但会显示带有 class 前缀

.. js:class:: MyAnimal(name[, age])

   :param string name: The name of the animal
   :param number age: an optional age for the animal

这将呈现为

class MyAnimal(name[, age])
参数:

  • name (string()) – 动物的名称

  • age (number()) – 动物的可选年龄

:single-line-parameter-list: (no value)

确保函数的参数将在单行逻辑行上发出，覆盖 javascript_maximum_signature_line_length 和 maximum_signature_line_length。

在版本 7.1 中添加。

.. js:data:: name

描述一个全局变量或常量。

.. js:attribute:: object.name

描述 object 的属性 name。

提供这些角色以引用描述的对象

:js:mod:
:js:func:
:js:meth:
:js:class:
:js:data:
:js:attr: