RubyGems - opal - Versions diffs - 0.11.0.rc1 → 0.11.0 - Mend

opal 0.11.0.rc1 → 0.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (493) hide show

checksums.yaml +4 -4
data/.jshintrc +1 -1
data/.travis.yml +14 -2
data/CHANGELOG.md +30 -5
data/HACKING.md +2 -2
data/README.md +4 -5
data/appveyor.yml +3 -4
data/bin +1 -0
data/docs/headless_chrome.md +105 -0
data/docs/rspec.md +2 -19
data/{bin → exe}/opal +0 -0
data/{bin → exe}/opal-build +0 -0
data/{bin → exe}/opal-mspec +0 -0
data/{bin → exe}/opal-repl +0 -0
data/lib/opal.rb +1 -0
data/lib/opal/ast/builder.rb +0 -4
data/lib/opal/builder.rb +69 -15
data/lib/opal/builder_processors.rb +8 -7
data/lib/opal/cli.rb +1 -1
data/lib/opal/cli_options.rb +1 -1
data/lib/opal/cli_runners.rb +1 -1
data/lib/opal/cli_runners/applescript.rb +0 -1
data/lib/opal/cli_runners/chrome.js +135 -0
data/lib/opal/cli_runners/chrome.rb +100 -0
data/lib/opal/cli_runners/nashorn.rb +0 -1
data/lib/opal/cli_runners/node_modules/.bin/chrome-remote-interface +1 -0
data/lib/opal/cli_runners/node_modules/chrome-remote-interface/LICENSE +18 -0
data/lib/opal/cli_runners/node_modules/chrome-remote-interface/README.md +843 -0
data/lib/opal/cli_runners/node_modules/chrome-remote-interface/bin/client.js +326 -0
data/lib/opal/cli_runners/node_modules/chrome-remote-interface/chrome-remote-interface.js +11 -0
data/lib/opal/cli_runners/node_modules/chrome-remote-interface/index.js +39 -0
data/lib/opal/cli_runners/node_modules/chrome-remote-interface/lib/api.js +84 -0
data/lib/opal/cli_runners/node_modules/chrome-remote-interface/lib/chrome.js +289 -0
data/lib/opal/cli_runners/node_modules/chrome-remote-interface/lib/defaults.js +4 -0
data/lib/opal/cli_runners/node_modules/chrome-remote-interface/lib/devtools.js +245 -0
data/lib/opal/cli_runners/node_modules/chrome-remote-interface/lib/external-request.js +23 -0
data/lib/opal/cli_runners/node_modules/chrome-remote-interface/lib/protocol.json +13303 -0
data/lib/opal/cli_runners/node_modules/chrome-remote-interface/lib/websocket-wrapper.js +32 -0
data/lib/opal/cli_runners/node_modules/chrome-remote-interface/package.json +128 -0
data/lib/opal/cli_runners/node_modules/chrome-remote-interface/webpack.config.js +55 -0
data/lib/opal/cli_runners/node_modules/commander/Readme.md +195 -0
data/lib/opal/cli_runners/node_modules/commander/index.js +851 -0
data/lib/opal/cli_runners/node_modules/commander/package.json +92 -0
data/lib/opal/cli_runners/node_modules/ultron/LICENSE +22 -0
data/lib/opal/cli_runners/node_modules/ultron/index.js +138 -0
data/lib/opal/cli_runners/node_modules/ultron/package.json +112 -0
data/lib/opal/cli_runners/node_modules/ws/LICENSE +21 -0
data/lib/opal/cli_runners/node_modules/ws/README.md +259 -0
data/lib/opal/cli_runners/node_modules/ws/SECURITY.md +33 -0
data/lib/opal/cli_runners/node_modules/ws/index.js +15 -0
data/lib/opal/cli_runners/node_modules/ws/lib/BufferUtil.fallback.js +56 -0
data/lib/opal/cli_runners/node_modules/ws/lib/BufferUtil.js +15 -0
data/lib/opal/cli_runners/node_modules/ws/lib/ErrorCodes.js +28 -0
data/lib/opal/cli_runners/node_modules/ws/lib/EventTarget.js +158 -0
data/lib/opal/cli_runners/node_modules/ws/lib/Extensions.js +69 -0
data/lib/opal/cli_runners/node_modules/ws/lib/PerMessageDeflate.js +339 -0
data/lib/opal/cli_runners/node_modules/ws/lib/Receiver.js +520 -0
data/lib/opal/cli_runners/node_modules/ws/lib/Sender.js +438 -0
data/lib/opal/cli_runners/node_modules/ws/lib/Validation.fallback.js +9 -0
data/lib/opal/cli_runners/node_modules/ws/lib/Validation.js +17 -0
data/lib/opal/cli_runners/node_modules/ws/lib/WebSocket.js +705 -0
data/lib/opal/cli_runners/node_modules/ws/lib/WebSocketServer.js +336 -0
data/lib/opal/cli_runners/node_modules/ws/package.json +122 -0
data/lib/opal/cli_runners/nodejs.rb +0 -1
data/lib/opal/cli_runners/package.json +5 -0
data/lib/opal/cli_runners/server.rb +0 -1
data/lib/opal/compiler.rb +8 -18
data/lib/opal/deprecations.rb +1 -1
data/lib/opal/eof_content.rb +36 -0
data/lib/opal/nodes.rb +0 -1
data/lib/opal/nodes/args/kwarg.rb +8 -6
data/lib/opal/nodes/args/kwoptarg.rb +12 -6
data/lib/opal/nodes/call.rb +3 -2
data/lib/opal/nodes/call_special.rb +10 -1
data/lib/opal/nodes/definitions.rb +5 -3
data/lib/opal/nodes/helpers.rb +4 -8
data/lib/opal/nodes/literal.rb +13 -1
data/lib/opal/nodes/logic.rb +19 -32
data/lib/opal/nodes/node_with_args.rb +1 -1
data/lib/opal/nodes/scope.rb +1 -0
data/lib/opal/nodes/super.rb +0 -4
data/lib/opal/nodes/variables.rb +11 -0
data/lib/opal/parser.rb +24 -19
data/lib/opal/path_reader.rb +17 -4
data/lib/opal/rewriter.rb +5 -1
data/lib/opal/rewriters/base.rb +37 -34
data/lib/opal/rewriters/binary_operator_assignment.rb +0 -3
data/lib/opal/rewriters/for_rewriter.rb +93 -0
data/lib/opal/rewriters/hashes/key_duplicates_rewriter.rb +58 -0
data/lib/opal/rewriters/js_reserved_words.rb +5 -8
data/lib/opal/rewriters/logical_operator_assignment.rb +0 -1
data/lib/opal/simple_server.rb +1 -0
data/lib/opal/util.rb +1 -1
data/lib/opal/version.rb +1 -1
data/opal.gemspec +32 -30
data/opal/corelib/array.rb +53 -30
data/opal/corelib/boolean.rb +11 -3
data/opal/corelib/comparable.rb +16 -0
data/opal/corelib/constants.rb +3 -3
data/opal/corelib/enumerable.rb +48 -1
data/opal/corelib/file.rb +54 -11
data/opal/corelib/hash.rb +98 -0
data/opal/corelib/io.rb +2 -2
data/opal/corelib/kernel.rb +28 -11
data/opal/corelib/marshal/read_buffer.rb +288 -150
data/opal/corelib/marshal/write_buffer.rb +27 -2
data/opal/corelib/nil.rb +11 -3
data/opal/corelib/number.rb +90 -20
data/opal/corelib/numeric.rb +3 -3
data/opal/corelib/random.rb +1 -1
data/opal/corelib/range.rb +22 -22
data/opal/corelib/regexp.rb +45 -4
data/opal/corelib/runtime.js +25 -9
data/opal/corelib/string.rb +1 -1
data/opal/corelib/string/encoding.rb +21 -29
data/opal/corelib/string/inheritance.rb +1 -1
data/opal/corelib/struct.rb +0 -5
data/opal/corelib/time.rb +1 -1
data/stdlib/buffer/array.rb +4 -2
data/stdlib/date.rb +46 -12
data/stdlib/headless_chrome.rb +11 -0
data/stdlib/nodejs/file.rb +36 -11
data/stdlib/nodejs/io.rb +8 -0
data/stdlib/nodejs/stacktrace.rb +116 -100
data/stdlib/opal-builder.rb +1 -0
data/stdlib/opal-platform.rb +6 -6
data/stdlib/opal/platform.rb +2 -2
data/stdlib/rbconfig.rb +1 -1
data/stdlib/securerandom.rb +1 -1
data/tasks/testing.rake +58 -26
data/tasks/testing/opal_rspec_smoketest.Gemfile +5 -12
metadata +64 -733
data/lib/opal/cli_runners/phantom.js +0 -69
data/lib/opal/cli_runners/phantomjs.rb +0 -29
data/lib/opal/hike_path_finder.rb +0 -19
data/lib/opal/nodes/for.rb +0 -75
data/spec/README.md +0 -10
data/spec/filters/bugs/array.rb +0 -16
data/spec/filters/bugs/basicobject.rb +0 -13
data/spec/filters/bugs/bigdecimal.rb +0 -146
data/spec/filters/bugs/class.rb +0 -11
data/spec/filters/bugs/comparable.rb +0 -5
data/spec/filters/bugs/complex.rb +0 -3
data/spec/filters/bugs/date.rb +0 -94
data/spec/filters/bugs/enumerable.rb +0 -43
data/spec/filters/bugs/enumerator.rb +0 -40
data/spec/filters/bugs/exception.rb +0 -72
data/spec/filters/bugs/file.rb +0 -8
data/spec/filters/bugs/float.rb +0 -39
data/spec/filters/bugs/hash.rb +0 -15
data/spec/filters/bugs/inheritance.rb +0 -5
data/spec/filters/bugs/integer.rb +0 -30
data/spec/filters/bugs/io.rb +0 -8
data/spec/filters/bugs/kernel.rb +0 -168
data/spec/filters/bugs/language.rb +0 -190
data/spec/filters/bugs/marshal.rb +0 -41
data/spec/filters/bugs/method.rb +0 -60
data/spec/filters/bugs/module.rb +0 -158
data/spec/filters/bugs/numeric.rb +0 -8
data/spec/filters/bugs/pathname.rb +0 -7
data/spec/filters/bugs/proc.rb +0 -37
data/spec/filters/bugs/random.rb +0 -7
data/spec/filters/bugs/range.rb +0 -36
data/spec/filters/bugs/rational.rb +0 -4
data/spec/filters/bugs/regexp.rb +0 -158
data/spec/filters/bugs/set.rb +0 -41
data/spec/filters/bugs/singleton.rb +0 -6
data/spec/filters/bugs/string.rb +0 -98
data/spec/filters/bugs/stringscanner.rb +0 -71
data/spec/filters/bugs/struct.rb +0 -4
data/spec/filters/bugs/time.rb +0 -35
data/spec/filters/bugs/unboundmethod.rb +0 -17
data/spec/filters/unsupported/array.rb +0 -167
data/spec/filters/unsupported/basicobject.rb +0 -14
data/spec/filters/unsupported/bignum.rb +0 -55
data/spec/filters/unsupported/class.rb +0 -4
data/spec/filters/unsupported/delegator.rb +0 -5
data/spec/filters/unsupported/enumerable.rb +0 -11
data/spec/filters/unsupported/enumerator.rb +0 -13
data/spec/filters/unsupported/file.rb +0 -4
data/spec/filters/unsupported/fixnum.rb +0 -14
data/spec/filters/unsupported/float.rb +0 -46
data/spec/filters/unsupported/freeze.rb +0 -75
data/spec/filters/unsupported/hash.rb +0 -43
data/spec/filters/unsupported/integer.rb +0 -3
data/spec/filters/unsupported/kernel.rb +0 -32
data/spec/filters/unsupported/language.rb +0 -22
data/spec/filters/unsupported/marshal.rb +0 -46
data/spec/filters/unsupported/matchdata.rb +0 -33
data/spec/filters/unsupported/math.rb +0 -3
data/spec/filters/unsupported/pathname.rb +0 -3
data/spec/filters/unsupported/privacy.rb +0 -279
data/spec/filters/unsupported/proc.rb +0 -3
data/spec/filters/unsupported/random.rb +0 -4
data/spec/filters/unsupported/range.rb +0 -7
data/spec/filters/unsupported/regexp.rb +0 -69
data/spec/filters/unsupported/set.rb +0 -4
data/spec/filters/unsupported/singleton.rb +0 -6
data/spec/filters/unsupported/string.rb +0 -546
data/spec/filters/unsupported/struct.rb +0 -6
data/spec/filters/unsupported/symbol.rb +0 -20
data/spec/filters/unsupported/taint.rb +0 -30
data/spec/filters/unsupported/thread.rb +0 -7
data/spec/filters/unsupported/time.rb +0 -202
data/spec/lib/builder_processors_spec.rb +0 -27
data/spec/lib/builder_spec.rb +0 -89
data/spec/lib/cli_runners/phantomjs_spec.rb +0 -39
data/spec/lib/cli_spec.rb +0 -240
data/spec/lib/compiler/call_spec.rb +0 -732
data/spec/lib/compiler_spec.rb +0 -294
data/spec/lib/config_spec.rb +0 -110
data/spec/lib/dependency_resolver_spec.rb +0 -40
data/spec/lib/deprecations_spec.rb +0 -16
data/spec/lib/fixtures/complex_sprockets.js.rb.erb +0 -4
data/spec/lib/fixtures/file_with_directives.js +0 -2
data/spec/lib/fixtures/jst_file.js.jst +0 -1
data/spec/lib/fixtures/no_requires.rb +0 -1
data/spec/lib/fixtures/opal_file.rb +0 -2
data/spec/lib/fixtures/require_tree_test.rb +0 -3
data/spec/lib/fixtures/required_file.js +0 -1
data/spec/lib/fixtures/required_tree_test/required_file1.rb +0 -1
data/spec/lib/fixtures/required_tree_test/required_file2.rb +0 -1
data/spec/lib/fixtures/requires.rb +0 -7
data/spec/lib/fixtures/source_location_test.rb +0 -7
data/spec/lib/fixtures/source_map.rb +0 -1
data/spec/lib/fixtures/source_map/subfolder/other_file.rb +0 -1
data/spec/lib/fixtures/sprockets_file.js.rb +0 -3
data/spec/lib/fixtures/sprockets_require_tree_test.rb +0 -3
data/spec/lib/hike_path_finder_spec.rb +0 -23
data/spec/lib/path_reader_spec.rb +0 -36
data/spec/lib/paths_spec.rb +0 -18
data/spec/lib/rewriters/binary_operator_assignment_spec.rb +0 -151
data/spec/lib/rewriters/block_to_iter_spec.rb +0 -28
data/spec/lib/rewriters/dot_js_syntax_spec.rb +0 -108
data/spec/lib/rewriters/explicit_writer_return_spec.rb +0 -186
data/spec/lib/rewriters/js_reserved_words_spec.rb +0 -116
data/spec/lib/rewriters/logical_operator_assignment_spec.rb +0 -202
data/spec/lib/rewriters/opal_engine_check_spec.rb +0 -82
data/spec/lib/rewriters/rubyspec/filters_rewriter_spec.rb +0 -53
data/spec/lib/shared/path_finder_shared.rb +0 -19
data/spec/lib/shared/path_reader_shared.rb +0 -31
data/spec/lib/simple_server_spec.rb +0 -54
data/spec/lib/spec_helper.rb +0 -100
data/spec/mspec-opal/formatters.rb +0 -236
data/spec/mspec-opal/runner.rb +0 -173
data/spec/opal/compiler/irb_spec.rb +0 -44
data/spec/opal/core/arity_spec.rb +0 -142
data/spec/opal/core/array/intersection_spec.rb +0 -38
data/spec/opal/core/array/minus_spec.rb +0 -38
data/spec/opal/core/array/select_spec.rb +0 -14
data/spec/opal/core/array/set_range_to_array_spec.rb +0 -7
data/spec/opal/core/array/union_spec.rb +0 -38
data/spec/opal/core/array/uniq_spec.rb +0 -49
data/spec/opal/core/date_spec.rb +0 -191
data/spec/opal/core/enumerable/all_break_spec.rb +0 -5
data/spec/opal/core/enumerable/any_break_spec.rb +0 -5
data/spec/opal/core/enumerable/collect_break_spec.rb +0 -13
data/spec/opal/core/enumerable/count_break_spec.rb +0 -5
data/spec/opal/core/enumerable/detect_break_spec.rb +0 -5
data/spec/opal/core/enumerable/drop_while_break_spec.rb +0 -5
data/spec/opal/core/enumerable/each_slice_break.rb +0 -6
data/spec/opal/core/enumerable/each_with_index_break_spec.rb +0 -5
data/spec/opal/core/enumerable/each_with_object_break_spec.rb +0 -5
data/spec/opal/core/enumerable/find_all_break_spec.rb +0 -5
data/spec/opal/core/enumerable/find_index_break_spec.rb +0 -5
data/spec/opal/core/enumerable/grep_break_spec.rb +0 -5
data/spec/opal/core/enumerable/max_break_spec.rb +0 -5
data/spec/opal/core/enumerable/max_by_break_spec.rb +0 -5
data/spec/opal/core/enumerable/min_break_spec.rb +0 -5
data/spec/opal/core/enumerable/min_by_break_spec.rb +0 -5
data/spec/opal/core/enumerable/none_break_spec.rb +0 -5
data/spec/opal/core/enumerable/one_break_spec.rb +0 -5
data/spec/opal/core/enumerable/reduce_break_spec.rb +0 -5
data/spec/opal/core/enumerable/take_while_break_spec.rb +0 -5
data/spec/opal/core/enumerator/with_index_spec.rb +0 -6
data/spec/opal/core/exception_spec.rb +0 -30
data/spec/opal/core/fixtures/class.rb +0 -124
data/spec/opal/core/fixtures/class_variables.rb +0 -0
data/spec/opal/core/fixtures/constants.rb +0 -33
data/spec/opal/core/fixtures/require_tree_files/file 1.rb +0 -1
data/spec/opal/core/fixtures/require_tree_files/file 2.rb +0 -1
data/spec/opal/core/fixtures/require_tree_files/file 3.rb +0 -1
data/spec/opal/core/fixtures/require_tree_files/file 4.rb +0 -1
data/spec/opal/core/fixtures/require_tree_files/file 5.rb +0 -1
data/spec/opal/core/fixtures/require_tree_files/nested/nested 1.rb +0 -1
data/spec/opal/core/fixtures/require_tree_files/nested/nested 2.rb +0 -1
data/spec/opal/core/fixtures/require_tree_files/other/other 1.rb +0 -1
data/spec/opal/core/fixtures/require_tree_with_dot/file 1.rb +0 -1
data/spec/opal/core/fixtures/require_tree_with_dot/file 2.rb +0 -1
data/spec/opal/core/fixtures/require_tree_with_dot/file 3.rb +0 -1
data/spec/opal/core/fixtures/require_tree_with_dot/index.rb +0 -3
data/spec/opal/core/hash/has_value_spec.rb +0 -13
data/spec/opal/core/hash/internals_spec.rb +0 -332
data/spec/opal/core/helpers_spec.rb +0 -14
data/spec/opal/core/kernel/Array_spec.rb +0 -10
data/spec/opal/core/kernel/at_exit_spec.rb +0 -70
data/spec/opal/core/kernel/block_given_spec.rb +0 -30
data/spec/opal/core/kernel/class_spec.rb +0 -6
data/spec/opal/core/kernel/define_singleton_method_spec.rb +0 -21
data/spec/opal/core/kernel/equal_value_spec.rb +0 -12
data/spec/opal/core/kernel/extend_spec.rb +0 -21
data/spec/opal/core/kernel/format_spec.rb +0 -122
data/spec/opal/core/kernel/freeze_spec.rb +0 -15
data/spec/opal/core/kernel/instance_eval_spec.rb +0 -28
data/spec/opal/core/kernel/instance_variable_defined_spec.rb +0 -15
data/spec/opal/core/kernel/instance_variable_get_spec.rb +0 -14
data/spec/opal/core/kernel/instance_variable_set_spec.rb +0 -10
data/spec/opal/core/kernel/instance_variables_spec.rb +0 -110
data/spec/opal/core/kernel/loop_spec.rb +0 -23
data/spec/opal/core/kernel/match_spec.rb +0 -5
data/spec/opal/core/kernel/method_spec.rb +0 -31
data/spec/opal/core/kernel/methods_spec.rb +0 -25
data/spec/opal/core/kernel/nil_spec.rb +0 -7
data/spec/opal/core/kernel/p_spec.rb +0 -15
data/spec/opal/core/kernel/printf_spec.rb +0 -11
data/spec/opal/core/kernel/proc_spec.rb +0 -13
data/spec/opal/core/kernel/raise_spec.rb +0 -13
data/spec/opal/core/kernel/rand_spec.rb +0 -19
data/spec/opal/core/kernel/require_tree_spec.rb +0 -18
data/spec/opal/core/kernel/respond_to_spec.rb +0 -44
data/spec/opal/core/kernel/send_spec.rb +0 -56
data/spec/opal/core/kernel/sprintf_spec.rb +0 -5
data/spec/opal/core/language/arguments/mlhs_arg_spec.rb +0 -19
data/spec/opal/core/language/class_spec.rb +0 -55
data/spec/opal/core/language/constant_lookup_spec.rb +0 -38
data/spec/opal/core/language/equal_spec.rb +0 -8
data/spec/opal/core/language/fixtures/array.rb +0 -11
data/spec/opal/core/language/fixtures/block.rb +0 -57
data/spec/opal/core/language/fixtures/break.rb +0 -240
data/spec/opal/core/language/fixtures/ensure.rb +0 -72
data/spec/opal/core/language/fixtures/literal_lambda.rb +0 -7
data/spec/opal/core/language/fixtures/metaclass.rb +0 -33
data/spec/opal/core/language/fixtures/module.rb +0 -24
data/spec/opal/core/language/fixtures/next.rb +0 -128
data/spec/opal/core/language/fixtures/return.rb +0 -118
data/spec/opal/core/language/fixtures/send.rb +0 -111
data/spec/opal/core/language/fixtures/send_1.9.rb +0 -22
data/spec/opal/core/language/fixtures/super.rb +0 -308
data/spec/opal/core/language/fixtures/variables.rb +0 -58
data/spec/opal/core/language/fixtures/yield.rb +0 -28
data/spec/opal/core/language/heredoc_spec.rb +0 -42
data/spec/opal/core/language/keyword_arguments_spec.rb +0 -11
data/spec/opal/core/language/predefined_spec.rb +0 -138
data/spec/opal/core/language/regexp_spec.rb +0 -20
data/spec/opal/core/language/rescue_spec.rb +0 -18
data/spec/opal/core/language/safe_navigator_spec.rb +0 -7
data/spec/opal/core/language/send_spec.rb +0 -222
data/spec/opal/core/language/string_spec.rb +0 -44
data/spec/opal/core/language/ternary_operator_spec.rb +0 -20
data/spec/opal/core/language/versions/array_1.9.rb +0 -39
data/spec/opal/core/language/versions/block_1.9.rb +0 -0
data/spec/opal/core/language/versions/break_1.9.rb +0 -0
data/spec/opal/core/language/versions/case_1.9.rb +0 -20
data/spec/opal/core/language/versions/def_2_0_spec.rb +0 -58
data/spec/opal/core/language/versions/hash_1_9_spec.rb +0 -23
data/spec/opal/core/language/versions/literal_lambda_1.9.rb +0 -143
data/spec/opal/core/language/versions/not_1.9.rb +0 -22
data/spec/opal/core/language/versions/send_1.9.rb +0 -241
data/spec/opal/core/language/versions/symbol_1.9.rb +0 -15
data/spec/opal/core/language/versions/variables_1.9.rb +0 -8
data/spec/opal/core/language_spec.rb +0 -77
data/spec/opal/core/marshal/dump_spec.rb +0 -53
data/spec/opal/core/marshal/load_spec.rb +0 -7
data/spec/opal/core/method/to_proc_spec.rb +0 -28
data/spec/opal/core/module/alias_method_spec.rb +0 -28
data/spec/opal/core/module/ancestors_spec.rb +0 -11
data/spec/opal/core/module/append_features_spec.rb +0 -14
data/spec/opal/core/module/attr_accessor_spec.rb +0 -26
data/spec/opal/core/module/const_defined_spec.rb +0 -84
data/spec/opal/core/module/const_get_spec.rb +0 -85
data/spec/opal/core/module/const_missing_spec.rb +0 -17
data/spec/opal/core/module/const_set_spec.rb +0 -64
data/spec/opal/core/module/constants_spec.rb +0 -49
data/spec/opal/core/module/fixtures/classes.rb +0 -444
data/spec/opal/core/module/method_defined_spec.rb +0 -48
data/spec/opal/core/module/method_lookup_spec.rb +0 -13
data/spec/opal/core/module/module_function_spec.rb +0 -25
data/spec/opal/core/module/name_spec.rb +0 -41
data/spec/opal/core/module/public_method_defined_spec.rb +0 -18
data/spec/opal/core/module/remove_const_spec.rb +0 -22
data/spec/opal/core/module/undef_method_spec.rb +0 -66
data/spec/opal/core/numeric/bit_and_spec.rb +0 -7
data/spec/opal/core/numeric/bit_or_spec.rb +0 -8
data/spec/opal/core/numeric/bit_xor_spec.rb +0 -6
data/spec/opal/core/numeric/ceil_spec.rb +0 -8
data/spec/opal/core/numeric/chr_spec.rb +0 -8
data/spec/opal/core/numeric/comparison_spec.rb +0 -24
data/spec/opal/core/numeric/complement_spec.rb +0 -8
data/spec/opal/core/numeric/divide_spec.rb +0 -10
data/spec/opal/core/numeric/eql_spec.rb +0 -9
data/spec/opal/core/numeric/exponent_spec.rb +0 -33
data/spec/opal/core/numeric/floor_spec.rb +0 -8
data/spec/opal/core/numeric/gt_spec.rb +0 -11
data/spec/opal/core/numeric/gte_spec.rb +0 -12
data/spec/opal/core/numeric/integer_spec.rb +0 -9
data/spec/opal/core/numeric/left_shift_spec.rb +0 -21
data/spec/opal/core/numeric/lt_spec.rb +0 -11
data/spec/opal/core/numeric/lte_spec.rb +0 -12
data/spec/opal/core/numeric/minus_spec.rb +0 -8
data/spec/opal/core/numeric/modulo_spec.rb +0 -19
data/spec/opal/core/numeric/multiply_spec.rb +0 -9
data/spec/opal/core/numeric/next_spec.rb +0 -9
data/spec/opal/core/numeric/ord_spec.rb +0 -9
data/spec/opal/core/numeric/plus_spec.rb +0 -8
data/spec/opal/core/numeric/pred_spec.rb +0 -7
data/spec/opal/core/numeric/right_shift_spec.rb +0 -25
data/spec/opal/core/numeric/step_spec.rb +0 -11
data/spec/opal/core/numeric/succ_spec.rb +0 -9
data/spec/opal/core/numeric/times_spec.rb +0 -36
data/spec/opal/core/numeric/to_f_spec.rb +0 -7
data/spec/opal/core/numeric/to_i_spec.rb +0 -7
data/spec/opal/core/numeric/to_json_spec.rb +0 -8
data/spec/opal/core/numeric/to_s_spec.rb +0 -26
data/spec/opal/core/numeric/uminus_spec.rb +0 -9
data/spec/opal/core/numeric/upto_spec.rb +0 -19
data/spec/opal/core/numeric/zero_spec.rb +0 -7
data/spec/opal/core/object_id_spec.rb +0 -56
data/spec/opal/core/proc/call_spec.rb +0 -21
data/spec/opal/core/proc/element_reference_spec.rb +0 -21
data/spec/opal/core/proc/proc_tricks_spec.rb +0 -7
data/spec/opal/core/runtime/begin_spec.rb +0 -39
data/spec/opal/core/runtime/block_spec.rb +0 -23
data/spec/opal/core/runtime/bridged_classes_spec.rb +0 -123
data/spec/opal/core/runtime/constants_spec.rb +0 -13
data/spec/opal/core/runtime/donate_spec.rb +0 -53
data/spec/opal/core/runtime/eval_spec.rb +0 -5
data/spec/opal/core/runtime/is_a_spec.rb +0 -36
data/spec/opal/core/runtime/main_methods_spec.rb +0 -27
data/spec/opal/core/runtime/method_missing_spec.rb +0 -68
data/spec/opal/core/runtime/method_spec.rb +0 -31
data/spec/opal/core/runtime/operator_call_spec.rb +0 -13
data/spec/opal/core/runtime/paren_spec.rb +0 -14
data/spec/opal/core/runtime/rescue_spec.rb +0 -106
data/spec/opal/core/runtime/return_spec.rb +0 -38
data/spec/opal/core/runtime/singleton_class_spec.rb +0 -13
data/spec/opal/core/runtime/super_spec.rb +0 -223
data/spec/opal/core/runtime/truthy_spec.rb +0 -63
data/spec/opal/core/runtime/variables_spec.rb +0 -20
data/spec/opal/core/runtime_spec.rb +0 -58
data/spec/opal/core/source_map_spec.rb +0 -49
data/spec/opal/core/string_spec.rb +0 -32
data/spec/opal/core/time_spec.rb +0 -38
data/spec/opal/javascript_api_spec.rb +0 -16
data/spec/opal/stdlib/erb/erb_spec.rb +0 -30
data/spec/opal/stdlib/erb/inline_block.opalerb +0 -3
data/spec/opal/stdlib/erb/quoted.opalerb +0 -1
data/spec/opal/stdlib/erb/simple.opalerb +0 -1
data/spec/opal/stdlib/js_spec.rb +0 -66
data/spec/opal/stdlib/json/ext_spec.rb +0 -48
data/spec/opal/stdlib/json/parse_spec.rb +0 -37
data/spec/opal/stdlib/native/alias_native_spec.rb +0 -27
data/spec/opal/stdlib/native/array_spec.rb +0 -11
data/spec/opal/stdlib/native/each_spec.rb +0 -13
data/spec/opal/stdlib/native/element_reference_spec.rb +0 -16
data/spec/opal/stdlib/native/exposure_spec.rb +0 -33
data/spec/opal/stdlib/native/ext_spec.rb +0 -19
data/spec/opal/stdlib/native/hash_spec.rb +0 -67
data/spec/opal/stdlib/native/initialize_spec.rb +0 -17
data/spec/opal/stdlib/native/method_missing_spec.rb +0 -51
data/spec/opal/stdlib/native/native_alias_spec.rb +0 -19
data/spec/opal/stdlib/native/native_class_spec.rb +0 -18
data/spec/opal/stdlib/native/native_module_spec.rb +0 -13
data/spec/opal/stdlib/native/native_reader_spec.rb +0 -22
data/spec/opal/stdlib/native/native_writer_spec.rb +0 -30
data/spec/opal/stdlib/native/new_spec.rb +0 -92
data/spec/opal/stdlib/native/struct_spec.rb +0 -12
data/spec/opal/stdlib/promise/always_spec.rb +0 -49
data/spec/opal/stdlib/promise/error_spec.rb +0 -15
data/spec/opal/stdlib/promise/rescue_spec.rb +0 -53
data/spec/opal/stdlib/promise/then_spec.rb +0 -79
data/spec/opal/stdlib/promise/trace_spec.rb +0 -51
data/spec/opal/stdlib/promise/value_spec.rb +0 -15
data/spec/opal/stdlib/promise/when_spec.rb +0 -34
data/spec/opal/stdlib/source_map_spec.rb +0 -8
data/spec/opal/stdlib/strscan/scan_spec.rb +0 -11
data/spec/opal/stdlib/template/paths_spec.rb +0 -10
data/spec/opal/stdlib/thread/mutex_spec.rb +0 -40
data/spec/opal/stdlib/thread/thread_queue_spec.rb +0 -32
data/spec/opal/stdlib/thread/thread_spec.rb +0 -60
data/spec/ruby_specs +0 -122
data/spec/spec_helper.rb +0 -27
data/spec/support/match_helpers.rb +0 -57
data/spec/support/mspec_rspec_adapter.rb +0 -33
data/spec/support/rewriters_helper.rb +0 -24
data/stdlib/phantomjs.rb +0 -17
data/tasks/testing/sprockets-phantomjs.js +0 -54
data/test/nodejs/fixtures/hello.rb +0 -1
data/test/nodejs/test_dir.rb +0 -17
data/test/nodejs/test_file.rb +0 -87
data/test/nodejs/test_io.rb +0 -18
data/test/nodejs/test_opal_builder.rb +0 -12
data/test/opal/test_keyword.rb +0 -590
data/test/opal/unsupported_and_bugs.rb +0 -39

data/lib/opal/builder_processors.rb CHANGED

@@ -5,13 +5,7 @@ require 'source_map'
 module Opal
   module BuilderProcessors
-    DEFAULT_PROCESSORS = []
     class Processor
-      def self.inherited(processor)
-        DEFAULT_PROCESSORS << processor
-      end
       def initialize(source, filename, options = {})
         @source, @filename, @options = source, filename, options
         @requires = []
@@ -27,8 +21,10 @@ module Opal
         @extensions = extensions
         matches = extensions.join('|')
         matches = "(#{matches})" if extensions.size == 1
         @match_regexp = Regexp.new "\\.#{matches}#{REGEXP_END}"
+        ::Opal::Builder.register_processor(self, extensions)
+        nil
       end
       def self.extensions
@@ -112,6 +108,11 @@ module Opal
       def compiler_class
         ::Opal::Compiler
       end
+      # Also catch a files with missing extensions and nil.
+      def self.match? other
+        super or File.extname(other.to_s) == ''
+      end
     end
     class OpalERBProcessor < RubyProcessor

data/lib/opal/cli.rb CHANGED

@@ -116,7 +116,7 @@ module Opal
     def show_sexp
       evals_or_file do |contents, filename|
-        buffer = ::Parser::Source::Buffer.new(filename)
+        buffer = ::Opal::Source::Buffer.new(filename)
         buffer.source = contents
         sexp = Opal::Parser.default_parser.parse(buffer)
         puts sexp.inspect

data/lib/opal/cli_options.rb CHANGED

@@ -81,7 +81,7 @@ module Opal
         options[:compile] = true
       end
-      on('-R', '--runner RUNNER', %w[nodejs server phantomjs applescript nashorn], 'Choose the runner: nodejs (default), server') do |runner|
+      on('-R', '--runner RUNNER', %w[nodejs server applescript nashorn chrome], 'Choose the runner: nodejs (default), server, chrome') do |runner|
         options[:runner] = runner.to_sym
       end

data/lib/opal/cli_runners.rb CHANGED

@@ -20,7 +20,7 @@ module Opal
 end
 require 'opal/cli_runners/applescript'
-require 'opal/cli_runners/phantomjs'
 require 'opal/cli_runners/nodejs'
 require 'opal/cli_runners/server'
 require 'opal/cli_runners/nashorn'
+require 'opal/cli_runners/chrome'

data/lib/opal/cli_runners/applescript.rb CHANGED

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-require 'opal/cli_runners'
 module Opal
   module CliRunners

data/lib/opal/cli_runners/chrome.js ADDED

@@ -0,0 +1,135 @@
+var CDP = require("chrome-remote-interface");
+var fs = require("fs");
+// NOTE: the code above doesn't work on Windows
+// and it doesn't support interactive stdin input (which is ok for our scenario)
+var opal_code = fs.readFileSync("/dev/stdin").toString();
+// Chrome can't handle huge data passed to `addScriptToEvaluateOnLoad`
+// https://groups.google.com/a/chromium.org/forum/#!topic/chromium-discuss/U5qyeX_ydBo
+// The only way is to create temporary files and pass them to chrome.
+fs.writeFileSync("/tmp/chrome-opal.js", opal_code);
+fs.writeFileSync("/tmp/chrome-opal.html", "" +
+  "<html>" +
+  "<head>" +
+    "<meta charset='utf-8'>" +
+    "<script src='chrome-opal.js'></script>" +
+  "</head>" +
+  "<body>" +
+  "</body>" +
+  "</html>"
+);
+var options = {
+  host: process.env.CHROME_HOST || 'localhost',
+  port: process.env.CHROME_PORT || 9222
+};
+CDP(options, function(client) {
+  var Page = client.Page,
+      Runtime = client.Runtime,
+      Console = client.Console;
+  Promise.all([
+    Console.enable(),
+    Page.enable(),
+    Runtime.enable(),
+  ]).then(function() {
+    // This hook catches only the first argument of `console.log`
+    // More advanced version Runtime.consoleAPICalled returns all arguments
+    // but all of them are not formatted, i.e. by calling
+    //   console.log('string', [1, 2, 3], {a: 'b'})
+    // it returns the following data to the callback:
+    //   {
+    //     "type":"log",
+    //     "args":[
+    //       {
+    //         "type":"string",
+    //         "value":"string"
+    //       },
+    //       {
+    //         "type":"object",
+    //         "subtype":"array",
+    //         "className":"Array",
+    //         "description":"Array(3)",
+    //         "objectId":"{\"injectedScriptId\":11,\"id\":1}",
+    //         "preview":{
+    //           "type":"object",
+    //           "subtype":"array",
+    //           "description":"Array(3)",
+    //           "overflow":false,
+    //           "properties":[
+    //             {"name":"0","type":"number","value":"1"},
+    //             {"name":"1","type":"number","value":"2"},
+    //             {"name":"2","type":"number","value":"3"}
+    //           ]
+    //         }
+    //       },
+    //       {
+    //         "type":"object",
+    //         "className":"Object",
+    //         "description":"Object",
+    //         "objectId":"{\"injectedScriptId\":11,\"id\":2}",
+    //         "preview":{
+    //           "type":"object",
+    //           "description":"Object",
+    //           "overflow":false,
+    //           "properties":[
+    //             {"name":"a","type":"string","value":"b"}
+    //           ]
+    //         }
+    //       }
+    //     ],
+    //     // ...
+    //   }
+    // Supporting this format for complex data structure is challenging, feel free to contribute!
+    //
+    Console.messageAdded(function(console_message) {
+      process.stdout.write(console_message.message.text);
+    });
+    Runtime.exceptionThrown(function(exception) {
+      var exceptionDetails = exception.exceptionDetails,
+          properties = exceptionDetails.exception.preview.properties,
+          stackTrace = exceptionDetails.stackTrace.callFrames,
+          name, message, trace = [], i;
+      for (i = 0; i < properties.length; i++) {
+        var property = properties[i];
+        if (property.name == "name") {
+          name = property.value;
+        }
+        if (property.name == "message") {
+          message = property.value;
+        }
+      }
+      console.log(name + " : " + message);
+      for (i = 0; i < stackTrace.length; i++) {
+        var raw = stackTrace[i];
+        console.log("    at " + raw.functionName + " (" + raw.url + ":" + raw.lineNumber + ":" + raw.columnNumber + ")")
+      }
+      process.exit(1);
+    })
+    Page.loadEventFired(() => {
+      Runtime.evaluate({ expression: "window.OPAL_EXIT_CODE" }).then(function(output) {
+        client.close();
+        if (typeof(output.result) !== "undefined" && output.result.type === "number") {
+          process.exit(output.result.value);
+        } else {
+          process.exit(0);
+        }
+      })
+    });
+    Page.navigate({ url: 'file:///tmp/chrome-opal.html' })
+  });
+});

data/lib/opal/cli_runners/chrome.rb ADDED

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+require 'shellwords'
+require 'socket'
+require 'timeout'
+module Opal
+  module CliRunners
+    class Chrome
+      SCRIPT_PATH = File.expand_path('../chrome.js', __FILE__).freeze
+      DEFAULT_CHROME_HOST = 'localhost'.freeze
+      DEFAULT_CHROME_PORT = 9222.freeze
+      def initialize(options)
+        @output = options.fetch(:output, $stdout)
+      end
+      attr_reader :output, :exit_status
+      def run(code, argv)
+        with_chrome_server do
+          cmd = [
+            'env',
+            "CHROME_HOST=#{chrome_host}",
+            "CHROME_PORT=#{chrome_port}",
+            'node',
+            SCRIPT_PATH,
+          ]
+          IO.popen(cmd, 'w', out: output) do |io|
+            io.write(code)
+          end
+          @exit_status = $?.exitstatus
+        end
+      end
+      private
+      def chrome_host
+        ENV['CHROME_HOST'] || DEFAULT_CHROME_HOST
+      end
+      def chrome_port
+        ENV['CHROME_PORT'] || DEFAULT_CHROME_PORT
+      end
+      def with_chrome_server
+        if chrome_server_running?
+          yield
+        else
+          run_chrome_server { yield }
+        end
+      end
+      def run_chrome_server
+        raise "Chrome server can be started only on localhost" if chrome_host != DEFAULT_CHROME_HOST
+        chrome_server_cmd = "#{chrome_executable} --headless --disable-gpu --remote-debugging-port=#{chrome_port} #{ENV['CHROME_OPTS']}"
+        puts chrome_server_cmd
+        chrome_pid = Process.spawn(chrome_server_cmd)
+        Timeout.timeout(1) do
+          loop do
+            break if chrome_server_running?
+            sleep 0.1
+          end
+        end
+        yield
+      rescue Timeout::Error
+        puts 'Failed to start chrome server'
+        puts 'Make sure that you have it installed and that its version is > 59'
+      ensure
+        Process.kill('HUP', chrome_pid) if chrome_pid
+      end
+      def chrome_server_running?
+        puts "Connecting to #{chrome_host}:#{chrome_port}..."
+        TCPSocket.new(chrome_host, chrome_port).close
+        true
+      rescue Errno::ECONNREFUSED, Errno::EADDRNOTAVAIL
+        false
+      end
+      def chrome_executable
+        ENV['GOOGLE_CHROME_BINARY'] || case RbConfig::CONFIG['host_os']
+        when /mswin|msys|mingw|cygwin|bccwin|wince|emc/
+          raise "Headless chrome is supported only by Mac OS and Linux"
+        when /darwin|mac os/
+          "/Applications/Google\\ Chrome.app/Contents/MacOS/Google\\ Chrome"
+        when /linux/
+          'google-chrome-stable'
+        when /solaris|bsd/
+          raise "Headless chrome is supported only by Mac OS and Linux"
+        end
+      end
+    end
+  end
+end

data/lib/opal/cli_runners/nashorn.rb CHANGED

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-require 'opal/cli_runners'
 require 'opal/paths'
 module Opal

data/lib/opal/cli_runners/node_modules/.bin/chrome-remote-interface ADDED

	@@ -0,0 +1 @@
1	+ lib/opal/cli_runners/node_modules/.bin/../chrome-remote-interface/bin/client.js

data/lib/opal/cli_runners/node_modules/chrome-remote-interface/LICENSE ADDED

@@ -0,0 +1,18 @@
+Copyright (c) 2017 Andrea Cardaci <cyrus.and@gmail.com>
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/lib/opal/cli_runners/node_modules/chrome-remote-interface/README.md ADDED

@@ -0,0 +1,843 @@
+chrome-remote-interface    [![Build Status](https://travis-ci.org/cyrus-and/chrome-remote-interface.svg?branch=master)](https://travis-ci.org/cyrus-and/chrome-remote-interface)
+=======================
+[Chrome Debugging Protocol] interface that helps to instrument Chrome (or any
+other suitable [implementation](#implementations)) by providing a simple
+abstraction of commands and notifications using a straightforward JavaScript
+API.
+This module is one of the many [third-party protocol clients][3rd-party].
+[3rd-party]: https://developer.chrome.com/devtools/docs/debugging-clients#chrome-remote-interface
+Sample API usage
+----------------
+The following snippet loads `https://github.com` and dumps every request made:
+```js
+const CDP = require('chrome-remote-interface');
+CDP((client) => {
+    // extract domains
+    const {Network, Page} = client;
+    // setup handlers
+    Network.requestWillBeSent((params) => {
+        console.log(params.request.url);
+    });
+    Page.loadEventFired(() => {
+        client.close();
+    });
+    // enable events then start!
+    Promise.all([
+        Network.enable(),
+        Page.enable()
+    ]).then(() => {
+        return Page.navigate({url: 'https://github.com'});
+    }).catch((err) => {
+        console.error(err);
+        client.close();
+    });
+}).on('error', (err) => {
+    // cannot connect to the remote endpoint
+    console.error(err);
+});
+```
+Find more examples in the [wiki], in particular notice how the above can be
+rewritten using the [`async`/`await`][async-await-example] primitives.
+[wiki]: https://github.com/cyrus-and/chrome-remote-interface/wiki
+[async-await-example]: https://github.com/cyrus-and/chrome-remote-interface/wiki/Async-await-example
+Installation
+------------
+    npm install chrome-remote-interface
+Install globally (`-g`) to just use the [bundled client](#bundled-client).
+Implementations
+---------------
+This module should work with every application implementing the
+[Chrome Debugging Protocol]. In particular, it has been tested against the
+following implementations:
+Implementation             | Protocol version   | [Protocol] | [List] | [New] | [Activate] | [Close] | [Version]
+---------------------------|--------------------|------------|--------|-------|------------|---------|-----------
+[Google Chrome][1.1]       | [tip-of-tree][1.2] | yes        | yes    | yes   | yes        | yes     | yes
+[Microsoft Edge][2.1]      | [*partial*][2.2]   | yes        | yes    | no    | no         | no      | yes
+[Node.js][3.1] ([v6.3.0]+) | [node][3.2]        | yes        | no     | no    | no         | no      | yes
+[Safari (iOS)][4.1]        | [*partial*][4.2]   | no         | yes    | no    | no         | no      | no
+[1.1]: #chromechromium
+[1.2]: https://chromedevtools.github.io/devtools-protocol/tot/
+[2.1]: #edge
+[2.2]: https://github.com/Microsoft/edge-diagnostics-adapter/wiki/Supported-features-and-API
+[3.1]: #nodejs
+[3.2]: https://chromedevtools.github.io/devtools-protocol/v8/
+[4.1]: #safari-ios
+[4.2]: http://trac.webkit.org/browser/trunk/Source/JavaScriptCore/inspector/protocol
+[v6.3.0]: https://nodejs.org/en/blog/release/v6.3.0/
+[Protocol]: #cdpprotocoloptions-callback
+[List]: #cdplistoptions-callback
+[New]: #cdpnewoptions-callback
+[Activate]: #cdpactivateoptions-callback
+[Close]: #cdpcloseoptions-callback
+[Version]: #cdpversionoptions-callback
+The meaning of *target* varies according to the implementation, for example,
+each Chrome tab represents a target whereas for Node.js a target is the
+currently inspected script.
+Setup
+-----
+An instance of either Chrome itself or another implementation needs to be
+running on a known port in order to use this module (defaults to
+`localhost:9222`).
+### Chrome/Chromium
+#### Desktop
+Start Chrome with the `--remote-debugging-port` option, for example:
+    google-chrome --remote-debugging-port=9222
+##### Headless
+Since version 59, additionally use the `--headless` option, for example:
+    google-chrome --headless --remote-debugging-port=9222
+#### Android
+Plug the device and enable the [port forwarding][adb], for example:
+    adb forward tcp:9222 localabstract:chrome_devtools_remote
+[adb]: https://developer.chrome.com/devtools/docs/remote-debugging-legacy
+##### WebView
+In order to be inspectable, a WebView must
+be [configured for debugging][webview] and the corresponding process ID must be
+known. There are several ways to obtain it, for example:
+    adb shell grep -a webview_devtools_remote /proc/net/unix
+Finally, port forwarding can be enabled as follows:
+    adb forward tcp:9222 localabstract:webview_devtools_remote_<pid>
+[webview]: https://developers.google.com/web/tools/chrome-devtools/remote-debugging/webviews#configure_webviews_for_debugging
+### Edge
+Install and run the [Edge Diagnostics Adapter][edge-adapter].
+[edge-adapter]: https://github.com/Microsoft/edge-diagnostics-adapter
+### Node.js
+Start Node.js with the `--inspect` option, for example:
+    node --inspect=9222 script.js
+### Safari (iOS)
+Install and run the [iOS WebKit Debug Proxy][iwdp].
+[iwdp]: https://github.com/google/ios-webkit-debug-proxy
+Bundled client
+--------------
+This module comes with a bundled client application that can be used to
+interactively control a remote instance.
+### Target management
+The bundled client exposes subcommands to interact with the HTTP frontend
+(e.g., [List](#cdplistoptions-callback), [New](#cdpnewoptions-callback), etc.),
+run with `--help` to display the list of available options.
+Here are some examples:
+```javascript
+$ chrome-remote-interface new 'http://example.com'
+{
+    "description": "",
+    "devtoolsFrontendUrl": "/devtools/inspector.html?ws=localhost:9222/devtools/page/b049bb56-de7d-424c-a331-6ae44cf7ae01",
+    "id": "b049bb56-de7d-424c-a331-6ae44cf7ae01",
+    "thumbnailUrl": "/thumb/b049bb56-de7d-424c-a331-6ae44cf7ae01",
+    "title": "",
+    "type": "page",
+    "url": "http://example.com/",
+    "webSocketDebuggerUrl": "ws://localhost:9222/devtools/page/b049bb56-de7d-424c-a331-6ae44cf7ae01"
+}
+$ chrome-remote-interface close 'b049bb56-de7d-424c-a331-6ae44cf7ae01'
+```
+### Inspection
+Using the `inspect` subcommand it is possible to
+perform [command execution](#clientdomainmethodparams-callback)
+and [event binding](#clientdomaineventcallback) in a REPL fashion. But unlike
+the regular API the callbacks are overridden to conveniently display the result
+of the commands and the message of the events. Also, the event binding is
+simplified here, executing a shorthand method (e.g., `Page.loadEventFired()`)
+toggles the event registration.
+Remember that the REPL interface provides completion.
+Here is a sample session:
+```javascript
+$ chrome-remote-interface inspect
+>>> Runtime.evaluate({expression: 'window.location.toString()'})
+{ result:
+   { result:
+      { type: 'string',
+        value: 'https://www.google.it/_/chrome/newtab?espv=2&ie=UTF-8' },
+     wasThrown: false } }
+>>> Page.enable()
+{ result: {} }
+>>> Page.loadEventFired() // registered
+{ 'Page.loadEventFired': true }
+>>> Page.loadEventFired() // unregistered
+{ 'Page.loadEventFired': false }
+>>> Page.loadEventFired() // registered
+{ 'Page.loadEventFired': true }
+>>> Page.navigate({url: 'https://github.com'})
+{ result: { frameId: '28677.1' } }
+{ 'Page.loadEventFired': { timestamp: 21385.383076 } }
+>>> Runtime.evaluate({expression: 'window.location.toString()'})
+{ result:
+   { result: { type: 'string', value: 'https://github.com/' },
+     wasThrown: false } }
+```
+#### Event filtering
+To reduce the amount of data displayed by the event listeners it is possible to
+provide a filter function. In this example only the resource URL is shown:
+```javascript
+$ chrome-remote-interface inspect
+>>> Network.enable()
+{ result: {} }
+>>> Network.requestWillBeSent(params => params.request.url)
+{ 'Network.requestWillBeSent': 'params => params.request.url' }
+>>> Page.navigate({url: 'https://www.wikipedia.org'})
+{ 'Network.requestWillBeSent': 'https://www.wikipedia.org/' }
+{ result: { frameId: '5530.1' } }
+{ 'Network.requestWillBeSent': 'https://www.wikipedia.org/portal/wikipedia.org/assets/img/Wikipedia_wordmark.png' }
+{ 'Network.requestWillBeSent': 'https://www.wikipedia.org/portal/wikipedia.org/assets/img/Wikipedia-logo-v2.png' }
+{ 'Network.requestWillBeSent': 'https://www.wikipedia.org/portal/wikipedia.org/assets/js/index-3b68787aa6.js' }
+{ 'Network.requestWillBeSent': 'https://www.wikipedia.org/portal/wikipedia.org/assets/js/gt-ie9-c84bf66d33.js' }
+{ 'Network.requestWillBeSent': 'https://www.wikipedia.org/portal/wikipedia.org/assets/img/sprite-bookshelf_icons.png?16ed124e8ca7c5ce9d463e8f99b2064427366360' }
+{ 'Network.requestWillBeSent': 'https://www.wikipedia.org/portal/wikipedia.org/assets/img/sprite-project-logos.png?9afc01c5efe0a8fb6512c776955e2ad3eb48fbca' }
+```
+Embedded documentation
+----------------------
+In both the REPL and the regular API every object of the protocol is *decorated*
+with the meta information found within the descriptor. In addition The
+`category` field is added, which determines if the member is a `command`, an
+`event` or a `type`.
+For example to learn how to call `Page.navigate`:
+```javascript
+>>> Page.navigate
+{ [Function]
+  category: 'command',
+  parameters: { url: { type: 'string', description: 'URL to navigate the page to.' } },
+  returns:
+   [ { name: 'frameId',
+       '$ref': 'FrameId',
+       hidden: true,
+       description: 'Frame id that will be navigated.' } ],
+  description: 'Navigates current page to the given URL.',
+  handlers: [ 'browser', 'renderer' ] }
+```
+To learn about the parameters returned by the `Network.requestWillBeSent` event:
+```javascript
+>>> Network.requestWillBeSent
+{ [Function]
+  category: 'event',
+  description: 'Fired when page is about to send HTTP request.',
+  parameters:
+   { requestId: { '$ref': 'RequestId', description: 'Request identifier.' },
+     frameId:
+      { '$ref': 'Page.FrameId',
+        description: 'Frame identifier.',
+        hidden: true },
+     loaderId: { '$ref': 'LoaderId', description: 'Loader identifier.' },
+     documentURL:
+      { type: 'string',
+        description: 'URL of the document this request is loaded for.' },
+     request: { '$ref': 'Request', description: 'Request data.' },
+     timestamp: { '$ref': 'Timestamp', description: 'Timestamp.' },
+     wallTime:
+      { '$ref': 'Timestamp',
+        hidden: true,
+        description: 'UTC Timestamp.' },
+     initiator: { '$ref': 'Initiator', description: 'Request initiator.' },
+     redirectResponse:
+      { optional: true,
+        '$ref': 'Response',
+        description: 'Redirect response data.' },
+     type:
+      { '$ref': 'Page.ResourceType',
+        optional: true,
+        hidden: true,
+        description: 'Type of this resource.' } } }
+```
+To inspect the `Network.Request` (note that unlike commands and events, types
+are named in upper camel case) type:
+```javascript
+>>> Network.Request
+{ category: 'type',
+  id: 'Request',
+  type: 'object',
+  description: 'HTTP request data.',
+  properties:
+   { url: { type: 'string', description: 'Request URL.' },
+     method: { type: 'string', description: 'HTTP request method.' },
+     headers: { '$ref': 'Headers', description: 'HTTP request headers.' },
+     postData:
+      { type: 'string',
+        optional: true,
+        description: 'HTTP POST request data.' },
+     mixedContentType:
+      { optional: true,
+        type: 'string',
+        enum: [Object],
+        description: 'The mixed content status of the request, as defined in http://www.w3.org/TR/mixed-content/' },
+     initialPriority:
+      { '$ref': 'ResourcePriority',
+        description: 'Priority of the resource request at the time request is sent.' } } }
+```
+Chrome Debugging Protocol versions
+----------------------------------
+`chrome-remote-interface` uses the [local version] of the protocol descriptor by
+default. This file is manually updated from time to time using
+`scripts/update-protocol.sh` and pushed to this repository.
+This behavior can be changed by setting the `remote` option to `true`
+upon [connection](#cdpoptions-callback), in which case the remote instance is
+*asked* to provide its own protocol descriptor.
+Chrome < 60.0.3097.0 is not able to do that, so in that case the protocol
+descriptor is fetched from the source repository.
+To override the above behavior there are basically three options:
+- pass a custom protocol descriptor upon [connection](#cdpoptions-callback)
+  (`protocol` option);
+- use the *raw* version of the [commands](#clientsendmethod-params-callback)
+  and [events](#event-domainmethod) interface;
+- update the local copy with `scripts/update-protocol.sh` (not present when
+  fetched with `npm install`).
+[local version]: lib/protocol.json
+Browser usage
+-------------
+This module is able to run within a web context, with obvious limitations
+though, namely external HTTP requests
+([List](#cdplistoptions-callback), [New](#cdpnewoptions-callback), etc.) cannot
+be performed directly, for this reason the user must provide a global
+`criRequest` in order to use them:
+```js
+function criRequest(options, callback) {}
+```
+`options` is the same object used by the Node.js `http` module and `callback` is
+a function taking two arguments: `err` (JavaScript `Error` object or `null`) and
+`data` (string result).
+### Using [webpack](https://webpack.github.io/)
+It just works, simply require this module:
+```js
+const CDP = require('chrome-remote-interface');
+```
+To use a non-minified version manually run webpack with:
+    DEBUG=true npm run webpack
+### Using *vanilla* JavaScript
+To generate a JavaScript file that can be used with a `<script>` element:
+1. run `npm install` from the root directory;
+2. manually run webpack with:
+        TARGET=var npm run webpack
+        TARGET=var DEBUG=true npm run webpack
+3. use as:
+    ```html
+    <script>
+      function criRequest(options, callback) { /*...*/ }
+    </script>
+    <script src="chrome-remote-interface.js"></script>
+    ```
+API
+---
+The API consists of three parts:
+- *DevTools* methods (for those [implementations](#implementations) that support
+  them, e.g., [List](#cdplistoptions-callback), [New](#cdpnewoptions-callback),
+  etc.);
+- [connection](#cdpoptions-callback) establishment;
+- the actual [protocol interaction](#class-cdp).
+### CDP([options], [callback])
+Connects to a remote instance using the [Chrome Debugging Protocol].
+`options` is an object with the following optional properties:
+- `host`: HTTP frontend host. Defaults to `localhost`;
+- `port`: HTTP frontend port. Defaults to `9222`;
+- `secure`: HTTPS/WSS frontend. Defaults to `false`;
+- `target`: determines which target this client should attach to. The behavior
+  changes according to the type:
+  - a `function` that takes the array returned by the `List` method and returns
+    a target or its numeric index relative to the array;
+  - a target `object` like those returned by the `New` and `List` methods;
+  - a `string` representing the raw WebSocket URL, in this case `host` and
+    `port` are not used to fetch the target list, yet they are used to complete
+    the URL if relative;
+  - a `string` representing the target id.
+  Defaults to a function which returns the first available target according to
+  the implementation (note that at most one connection can be established to the
+  same target);
+- `protocol`: [Chrome Debugging Protocol] descriptor object. Defaults to use the
+  protocol chosen according to the `remote` option;
+- `remote`: a boolean indicating whether the protocol must be fetched *remotely*
+  or if the local version must be used. It has no effect if the `protocol`
+  option is set. Defaults to `false`.
+These options are also valid properties of all the instances of the `CDP` class.
+`callback` is a listener automatically added to the `connect` event of the
+returned `EventEmitter`. When `callback` is omitted a `Promise` object is
+returned which becomes fulfilled if the `connect` event is triggered and
+rejected if the `error` event is triggered.
+The `EventEmitter` supports the following events:
+#### Event: 'connect'
+```javascript
+function (client) {}
+```
+Emitted when the connection to the WebSocket is established.
+`client` is an instance of the `CDP` class.
+#### Event: 'error'
+```javascript
+function (err) {}
+```
+Emitted when `http://host:port/json` cannot be reached or if it is not possible
+to connect to the WebSocket.
+`err` is an instance of `Error`.
+### CDP.Protocol([options], [callback])
+Fetch the [Chrome Debugging Protocol] descriptor.
+`options` is an object with the following optional properties:
+- `host`: HTTP frontend host. Defaults to `localhost`;
+- `port`: HTTP frontend port. Defaults to `9222`;
+- `secure`: HTTPS/WSS frontend. Defaults to `false`;
+- `remote`: a boolean indicating whether the protocol must be fetched *remotely*
+  or if the local version must be returned. If it is not possible to fulfill the
+  request then the local version is used. Defaults to `false`.
+`callback` is executed when the protocol is fetched, it gets the following
+arguments:
+- `err`: a `Error` object indicating the success status;
+- `protocol`: an object with the following properties:
+   - `remote`: a boolean indicating whether the returned descriptor is the
+     remote version or not (due to user choice or error);
+   - `descriptor`: the [Chrome Debugging Protocol] descriptor.
+When `callback` is omitted a `Promise` object is returned.
+For example:
+```javascript
+const CDP = require('chrome-remote-interface');
+CDP.Protocol(function (err, protocol) {
+    if (!err) {
+        console.log(JSON.stringify(protocol.descriptor, null, 4));
+    }
+});
+```
+### CDP.List([options], [callback])
+Request the list of the available open targets/tabs of the remote instance.
+`options` is an object with the following optional properties:
+- `host`: HTTP frontend host. Defaults to `localhost`;
+- `port`: HTTP frontend port. Defaults to `9222`;
+- `secure`: HTTPS/WSS frontend. Defaults to `false`.
+`callback` is executed when the list is correctly received, it gets the
+following arguments:
+- `err`: a `Error` object indicating the success status;
+- `targets`: the array returned by `http://host:port/json/list` containing the
+  target list.
+When `callback` is omitted a `Promise` object is returned.
+For example:
+```javascript
+const CDP = require('chrome-remote-interface');
+CDP.List(function (err, targets) {
+    if (!err) {
+        console.log(targets);
+    }
+});
+```
+### CDP.New([options], [callback])
+Create a new target/tab in the remote instance.
+`options` is an object with the following optional properties:
+- `host`: HTTP frontend host. Defaults to `localhost`;
+- `port`: HTTP frontend port. Defaults to `9222`;
+- `secure`: HTTPS/WSS frontend. Defaults to `false`;
+- `url`: URL to load in the new target/tab. Defaults to `about:blank`.
+`callback` is executed when the target is created, it gets the following
+arguments:
+- `err`: a `Error` object indicating the success status;
+- `target`: the object returned by `http://host:port/json/new` containing the
+  target.
+When `callback` is omitted a `Promise` object is returned.
+For example:
+```javascript
+const CDP = require('chrome-remote-interface');
+CDP.New(function (err, target) {
+    if (!err) {
+        console.log(target);
+    }
+});
+```
+### CDP.Activate([options], [callback])
+Activate an open target/tab of the remote instance.
+`options` is an object with the following properties:
+- `host`: HTTP frontend host. Defaults to `localhost`;
+- `port`: HTTP frontend port. Defaults to `9222`;
+- `secure`: HTTPS/WSS frontend. Defaults to `false`;
+- `id`: Target id. Required, no default.
+`callback` is executed when the response to the activation request is
+received. It gets the following arguments:
+- `err`: a `Error` object indicating the success status;
+When `callback` is omitted a `Promise` object is returned.
+For example:
+```javascript
+const CDP = require('chrome-remote-interface');
+CDP.Activate({'id': 'CC46FBFA-3BDA-493B-B2E4-2BE6EB0D97EC'}, function (err) {
+    if (!err) {
+        console.log('target is activated');
+    }
+});
+```
+### CDP.Close([options], [callback])
+Close an open target/tab of the remote instance.
+`options` is an object with the following properties:
+- `host`: HTTP frontend host. Defaults to `localhost`;
+- `port`: HTTP frontend port. Defaults to `9222`;
+- `secure`: HTTPS/WSS frontend. Defaults to `false`;
+- `id`: Target id. Required, no default.
+`callback` is executed when the response to the close request is received. It
+gets the following arguments:
+- `err`: a `Error` object indicating the success status;
+When `callback` is omitted a `Promise` object is returned.
+For example:
+```javascript
+const CDP = require('chrome-remote-interface');
+CDP.Close({'id': 'CC46FBFA-3BDA-493B-B2E4-2BE6EB0D97EC'}, function (err) {
+    if (!err) {
+        console.log('target is closing');
+    }
+});
+```
+Note that the callback is fired when the target is *queued* for removal, but the
+actual removal will occur asynchronously.
+### CDP.Version([options], [callback])
+Request version information from the remote instance.
+`options` is an object with the following optional properties:
+- `host`: HTTP frontend host. Defaults to `localhost`;
+- `port`: HTTP frontend port. Defaults to `9222`;
+- `secure`: HTTPS/WSS frontend. Defaults to `false`.
+`callback` is executed when the version information is correctly received, it
+gets the following arguments:
+- `err`: a `Error` object indicating the success status;
+- `info`: a JSON object returned by `http://host:port/json/version` containing
+  the version information.
+When `callback` is omitted a `Promise` object is returned.
+For example:
+```javascript
+const CDP = require('chrome-remote-interface');
+CDP.Version(function (err, info) {
+    if (!err) {
+        console.log(info);
+    }
+});
+```
+### Class: CDP
+#### Event: 'event'
+```javascript
+function (message) {}
+```
+Emitted when the remote instance sends any notification through the WebSocket.
+`message` is the object received, it has the following properties:
+- `method`: a string describing the notification (e.g.,
+  `'Network.requestWillBeSent'`);
+- `params`: an object containing the payload.
+Refer to the [Chrome Debugging Protocol] specification for more information.
+For example:
+```javascript
+client.on('event', function (message) {
+    if (message.method === 'Network.requestWillBeSent') {
+        console.log(message.params);
+    }
+});
+```
+#### Event: '`<domain>`.`<method>`'
+```javascript
+function (params) {}
+```
+Emitted when the remote instance sends a notification for `<domain>.<method>`
+through the WebSocket.
+`params` is an object containing the payload.
+This is just a utility event which allows to easily listen for specific
+notifications (see [`'event'`](#event-event)), for example:
+```javascript
+client.on('Network.requestWillBeSent', console.log);
+```
+#### Event: 'ready'
+```javascript
+function () {}
+```
+Emitted every time that there are no more pending commands waiting for a
+response from the remote instance. The interaction is asynchronous so the only
+way to serialize a sequence of commands is to use the callback provided by
+the [`send`](#clientsendmethod-params-callback) method. This event acts as a
+barrier and it is useful to avoid the *callback hell* in certain simple
+situations.
+Users are encouraged to extensively check the response of each method and should
+prefer the promises API when dealing with complex asynchronous program flows.
+For example to load a URL only after having enabled the notifications of both
+`Network` and `Page` domains:
+```javascript
+client.Network.enable();
+client.Page.enable();
+client.once('ready', function () {
+    client.Page.navigate({'url': 'https://github.com'});
+});
+```
+In this particular case, not enforcing this kind of serialization may cause that
+the remote instance does not properly deliver the desired notifications the
+client.
+#### Event: 'disconnect'
+```javascript
+function () {}
+```
+Emitted when the instance closes the WebSocket connection.
+This may happen for example when the user opens DevTools or when the tab is
+closed.
+#### client.send(method, [params], [callback])
+Issue a command to the remote instance.
+`method` is a string describing the command.
+`params` is an object containing the payload.
+`callback` is executed when the remote instance sends a response to this
+command, it gets the following arguments:
+- `error`: a boolean value indicating the success status, as reported by the
+  remote instance;
+- `response`: an object containing either the response (`result` field, if
+  `error === false`) or the indication of the error (`error` field, if `error
+  === true`).
+When `callback` is omitted a `Promise` object is returned instead, with the
+fulfilled/rejected states implemented according to the `error` parameter.
+Note that the field `id` mentioned in the [Chrome Debugging Protocol]
+specification is managed internally and it is not exposed to the user.
+For example:
+```javascript
+client.send('Page.navigate', {'url': 'https://github.com'}, console.log);
+```
+#### client.`<domain>`.`<method>`([params], [callback])
+Just a shorthand for:
+```javascript
+client.send('<domain>.<method>', params, callback);
+```
+For example:
+```javascript
+client.Page.navigate({'url': 'https://github.com'}, console.log);
+```
+#### client.`<domain>`.`<event>`([callback])
+Just a shorthand for:
+```javascript
+client.on('<domain>.<event>', callback);
+```
+The only difference is that when `callback` is omitted the event is registered
+only once and a `Promise` object is returned.
+For example:
+```javascript
+client.Network.requestWillBeSent(console.log);
+```
+#### client.close([callback])
+Close the connection to the remote instance.
+`callback` is executed when the WebSocket is successfully closed.
+When `callback` is omitted a `Promise` object is returned.
+Contributors
+------------
+- [Andrey Sidorov](https://github.com/sidorares)
+- [Greg Cochard](https://github.com/gcochard)
+Resources
+---------
+- [Chrome Debugging Protocol]
+- [Chrome Debugging Protocol Google group](https://groups.google.com/forum/#!forum/chrome-debugging-protocol)
+- [devtools-protocol official repo](https://github.com/ChromeDevTools/devtools-protocol)
+- [Showcase Chrome Debugging Protocol Clients](https://developer.chrome.com/devtools/docs/debugging-clients)
+- [Awesome chrome-devtools](https://github.com/ChromeDevTools/awesome-chrome-devtools)
+[Chrome Debugging Protocol]: https://chromedevtools.github.io/devtools-protocol/