Harmony 项目技术文档

2024-12-20 15:05:24作者：沈韬淼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项目。

登录后查看全文

项目优选

收起

kernel

deepin linux kernel

docs

OpenHarmony documentation | OpenHarmony开发者文档

Ascend Extension for PyTorch

本项目是CANN提供的数学类基础计算算子库，实现网络在NPU上加速计算。

Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台，包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分，采用java语言实现，可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用

Java

RuoYi-Vue3

🎉 (RuoYi)官方仓库基于SpringBoot，Spring Security，JWT，Vue3 & Vite、Element Plus 的前后端分离权限管理系统

🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer（第 2 版）》、《程序员面试金典（第 6 版）》题解