jasmine-jquery 技术文档

1. 安装指南

1.1 下载并手动引入

你可以直接从 GitHub 下载 jasmine-jquery.js 文件，并将其包含在你的 Jasmine 测试运行文件中。确保同时引入 jQuery 库，因为 jasmine-jquery 依赖于它。

1.2 使用 Bower 安装

通过 Bower 安装 jasmine-jquery，运行以下命令：

bower install jasmine-jquery --save

1.3 在 Ruby on Rails 中使用

对于 Ruby on Rails 项目，可以使用 jasmine-jquery-rails gem。推荐遵循标准的 RSpec 和 Jasmine 框架目录结构，将测试文件放在 spec/javascripts/ 目录下。将 jasmine-jquery 和其他库（如 jasmine-ajax）放在 spec/javascripts/helpers 目录中，并将 fixtures 放在 spec/javascripts/fixtures 目录中。

2. 项目的使用说明

jasmine-jquery 为 Jasmine JavaScript 测试框架提供了两个扩展：

• jQuery 自定义匹配器：用于测试 jQuery 框架的元素。
• HTML、CSS 和 JSON 的 fixtures 处理 API：用于在测试中加载和处理 HTML、CSS 和 JSON 数据。

2.1 jQuery 自定义匹配器

jasmine-jquery 提供了多种自定义匹配器，用于测试 jQuery 元素的各种属性、状态和行为。例如：

• toBeChecked()：检查元素是否被选中。
• toBeDisabled()：检查元素是否被禁用。
• toBeVisible()：检查元素是否可见。
• toHaveText(string)：检查元素是否包含指定的文本。

2.2 HTML Fixtures

jasmine-jquery 的 Fixture 模块允许你在测试中加载 HTML 内容。你可以将 HTML 内容放在外部文件中，然后在测试中通过 loadFixtures 方法加载。

例如，在 myfixture.html 文件中：

<div id="my-fixture">some complex content here</div>

在测试中：

loadFixtures('myfixture.html');
$('#my-fixture').myTestedPlugin();
expect($('#my-fixture')).to...

3. 项目API使用文档

3.1 自定义匹配器 API

jasmine-jquery 提供了丰富的自定义匹配器，用于测试 jQuery 元素的各种属性、状态和行为。以下是一些常用的匹配器：

• toBeChecked()：检查元素是否被选中。
• toBeDisabled()：检查元素是否被禁用。
• toBeVisible()：检查元素是否可见。
• toHaveText(string)：检查元素是否包含指定的文本。
• toHaveClass(className)：检查元素是否包含指定的类名。
• toHaveHtml(string)：检查元素是否包含指定的 HTML 内容。

3.2 Fixtures API

jasmine-jquery 提供了多种方法来加载和管理 fixtures：

• load(fixtureUrl[, fixtureUrl, ...])：从文件加载一个或多个 fixtures，并自动将其附加到 DOM 中。
• read(fixtureUrl[, fixtureUrl, ...])：从文件加载一个或多个 fixtures，但不将其附加到 DOM 中，而是返回其内容。
• set(html)：直接设置 HTML 内容，并自动将其附加到 DOM 中。
• preload(fixtureUrl[, fixtureUrl, ...])：预加载一个或多个 fixtures，并将其存储在缓存中，以便后续使用。

4. 项目安装方式

4.1 手动安装

直接下载 jasmine-jquery.js 文件，并将其包含在你的 Jasmine 测试运行文件中。确保同时引入 jQuery 库。

4.2 使用 Bower 安装

通过 Bower 安装 jasmine-jquery，运行以下命令：

bower install jasmine-jquery --save

4.3 在 Ruby on Rails 中安装

使用 jasmine-jquery-rails gem 进行安装，并遵循标准的 RSpec 和 Jasmine 框架目录结构。