Opal 有source map 支持,方便这种源码级别的调试。我不会详细介绍源地图,但HTML5Rocks有一篇很棒的文章深入介绍了该主题。
这是使用 Opal 进行设置的最小样板:
让index.rb
我们的源文件:
class Test
def initialize
end
def crash
print x
end
end
Test.new.crash
既然您不想使用很多无关的实用程序,那么让我们直接使用 Opal API。创建一个builder.rb
将编译上述文件的文件:
require 'opal'
Opal::Processor.source_map_enabled = true
Opal.append_path "."
builder = Opal::Builder.new.build('index')
# Write the output file containing a referece to sourcemap
# which we generate below : this will help the browser locate the
# sourcemap. Note that we are generating sourcemap for only code and not
# the entire Opal corelib.
#
File.binwrite "build.js", "#{builder.to_s}\n//# sourceMappingURL=build.js.map"
File.binwrite "build.js.map", builder.source_map.to_s
File.binwrite "opal_lib.js", Opal::Builder.build('opal_lib')
还要创建一个opal_lib.rb
仅包含以下内容的文件:
require 'opal'
最后创建一个index.html
允许我们在浏览器中运行脚本。
<!DOCTYPE html>
<html>
<head>
<script src="opal_lib.js"></script>
<script src="build.js"></script>
</head>
<body>
</body>
</html>
现在要实际编译您的文件,请运行:
ruby builder.rb
这将生成已编译的 javascript 文件opal_lib.js
,build.js
并由我们的index.html
文件引用。现在只需index.html
在浏览器中打开。您将获得完整的调用堆栈和源视图:
源文件的行号可用:
作为使用浏览器的替代方案,您还可以使用 Node.js 来实现相同的目的。这需要您拥有Node.js
并npm
安装。您还需要安装 npm 模块source-map-support
npm install source-map-support
现在您可以打开节点 repl 并输入以下内容:
require('source-map-support').install();
require('./opal_lib');
require('./build');
您将获得具有正确源代码行号的堆栈跟踪:
/home/gaurav/Workspace/opal-playground/opal_lib.js:4436
Error.captureStackTrace(err);
^
NoMethodError: undefined method `x' for #<Test:0x102>
at OpalClass.$new (/home/gaurav/Workspace/opal-playground/opal_lib.js:4436:15)
at OpalClass.$exception (/home/gaurav/Workspace/opal-playground/opal_lib.js:4454:31)
at $Test.$raise (/home/gaurav/Workspace/opal-playground/opal_lib.js:4204:31)
at $Test.Opal.defn.TMP_1 (/home/gaurav/Workspace/opal-playground/opal_lib.js:3032:19)
at $Test.method_missing_stub [as $x] (/home/gaurav/Workspace/opal-playground/opal_lib.js:886:35)
at $Test.$crash (/home/gaurav/Workspace/opal-playground/index.rb:8:11)
at /home/gaurav/Workspace/opal-playground/index.rb:13:10
at Object.<anonymous> (/home/gaurav/Workspace/opal-playground/index.rb:13:10)
at Module._compile (module.js:435:26)
at Object.Module._extensions..js (module.js:442:10)
我建议您使用bundler进行 gem 管理。这是Gemfile
获取 Opal 大师的方法:
source 'http://production.cf.rubygems.org'
gem 'opal', github: 'opal/opal'
要编译,您必须运行:
bundle install
bundle exec ruby builder.rb
其他人提到的 Sprockets 集成/机架集成在下面使用相同的 API,从而抽象出管道。
更新:
由于我们在堆栈中有正确的行号,因此以编程方式解析堆栈并将此行号提取到变量中是公平的:
require('./opal_lib');
require('source-map-support').install();
var $e = null;
try {
require('./build');
} catch (e) {
$e = e;
}
var lines = e.split('\n').map(function(line){ return line.match(/^.*\((\S+):(\d+):(\d+)\)/) })
var first_source_line;
for (var i = 0; i < lines.length ; i++) {
var match = lines[i];
if (match == null) continue;
if (match[1].match(/index.rb$/) {
first_source_line = match;
break;
}
}
var line_number;
if (first_source_line) line_number = first_source_line[2] // ==> 8
当然你也可以用 ruby 来做(但如果你在浏览器中运行它,你也必须在此处包含 source-map-support):
class Test
def initialize
end
def crash
print x
end
end
line_num = nil
begin
Test.new.crash
rescue => e
if line = e.backtrace.map{|line| line.match(/^.*\((\S+):(\d+):(\d+)\)/) }.compact.find{|match| match[1] =~ /index.rb$/ }
line_num = line[2]
end
end
puts "line_num => #{line_num}" # ==> 8