Harmony 项目技术文档

2024-12-18 08:13:26作者：沈韬淼Beryl

1. 安装指南

在安装Harmony之前，需要确保环境中已经安装了一些依赖项。以下是手动安装这些依赖项的步骤：

首先，安装stackdeck库：

gem install stackdeck

接着，安装johnson库的特定版本：

gem install johnson -v "2.0.0.pre3"

最后，安装Harmony库：

gem install harmony

请注意，当前Ruby的gem包管理器中存在一个bug，因此需要手动安装这些依赖项。预计这个问题将在未来的版本中得到修复。

2. 项目的使用说明

Harmony提供了一个简单的领域特定语言（DSL），允许在Ruby中执行JavaScript和DOM代码。以下是一些使用示例：

JavaScript解析

require 'harmony'

page = Harmony::Page.new(<<-HTML)
  <html>
    <head>
      <title>Foo</title>
    </head>
    <body></body>
  </html>
HTML

puts page.execute_js("1+1")            # 输出: 2
puts page.execute_js("document.title") # 输出: "Foo"

JavaScript单元测试

Harmony可以用于在Ruby应用程序的测试中执行JavaScript代码，例如：

require 'test/unit'
require 'harmony'

class JavascriptTest < Test::Unit::TestCase
  def setup
    @page = Harmony::Page.new
    @page.load('public/javascripts/foo.js')
  end

  def test_foo
    assert_equal "world", @page.execute_js(<<-JS)
      foo = new Foo;
      foo.hello();
    JS
  end
end

DOM处理

Harmony支持在页面中使用JavaScript框架，如jQuery或Prototype。所有在<script>标签中引用的脚本都会自动加载。

page = Harmony::Page.new(<<-HTML)
  <html>
    <head>
      <script src="javascripts/jquery.js" type="text/javascript"></script>
    </head>
    <body>
      <div id="widget">ohaie</div>
    </body>
  </html>
HTML

puts page.execute_js("$('#widget').innerHTML") # 输出: "ohaie"

获取远程文档

使用Harmony::Page.fetch(uri)方法可以从远程文档创建一个页面。

page = Harmony::Page.fetch('http://example.com')
puts page.execute_js('document.title') # 输出: "Example Web Page"

3. 项目API使用文档

以下是Harmony项目中主要的API文档：

Harmony::Page.new(html): 创建一个新的页面实例，并可选地加载HTML内容。
page.execute_js(js_code): 执行JavaScript代码并返回最后一个语句的值。
page.load(file_path): 加载本地JavaScript文件到页面中。
Harmony::Page.fetch(uri): 从提供的URI创建一个页面实例。

4. 项目安装方式

项目的安装方式已在“安装指南”部分详细说明，这里不再赘述。简要步骤为：

安装依赖库stackdeck和johnson。
安装Harmony库。

请确保遵循上述步骤以成功安装Harmony项目。

harmony

Javascript + DOM in your ruby, the simple way

项目地址：https://gitcode.com/gh_mirrors/harmony9/harmony

项目优选

收起

本仓将收集和展示高质量的仓颉示例代码，欢迎大家投稿，让全世界看到您的妙趣设计，也让更多人通过您的编码理解和喜爱仓颉语言。

Cangjie

196

openHiTLS

旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件，通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求，让密码技术应用更简单，同时探索后量子等先进算法创新实践，构建密码前沿技术底座！

HarmonyOS-Examples

本仓将收集和展示仓颉鸿蒙应用示例代码，欢迎大家投稿，在仓颉鸿蒙社区展现你的妙趣设计！

Cangjie

268

qwerty-learner

为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers

TSX

333

CangjieCommunity

为仓颉编程语言开发者打造活跃、开放、高质量的社区环境

Markdown

896

advanced-java

Advanced-Java是一个Java进阶教程，适合用于学习Java高级特性和编程技巧。特点：内容深入、实例丰富、适合进阶学习。

前端智能化场景解决方案UI库，轻松构建你的AI应用，我们将持续完善更新，欢迎你的使用与建议。官网地址：https://matechat.gitcode.com

144

HarmonyOS-Cangjie-Cases

参考 HarmonyOS-Cases/Cases，提供仓颉开发鸿蒙 NEXT 应用的案例集

Cangjie

Harmony 项目技术文档

1. 安装指南

2. 项目的使用说明

JavaScript解析

JavaScript单元测试

DOM处理

获取远程文档

3. 项目API使用文档

4. 项目安装方式

热门内容推荐

最新内容推荐

项目优选

Harmony 项目技术文档

1. 安装指南

2. 项目的使用说明

JavaScript解析

JavaScript单元测试

DOM处理

获取远程文档

3. 项目API使用文档

4. 项目安装方式

相关内容推荐

热门内容推荐

最新内容推荐

项目优选