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

opal 0.11.0.rc1 → 0.11.0

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/