obxcura 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f2f8eab2a1520c5f96b85a50ddafee3b7938cd88014e1b288bb4d7a2839454ba
-  data.tar.gz: 2d81b467a60b702cfeea5d90792d184f2362f9f2bf96f9a26fdfce68929be12d
+  metadata.gz: d0870aca291d2df42d4229d960e6382150034ee7a7294a1b75829392d0e13188
+  data.tar.gz: 9daacc30f29cfd803cab0135173ca1466f75f27e077ccba09f578a3b4edcc8dc
 SHA512:
-  metadata.gz: 43e149575bda036ff64b42670f8b86147999142538cc89f459bace265ac3cef2f1feccbea1dda40adec6dbed151958d8ae8d2f40941f40155093226e8cf8232e
-  data.tar.gz: ea2770f6a9799e45ab8d1dbbb7c79a7b62c621305831a319f182d7cae3fdc2f257f0a49be55d1757e387065bc6e52ae4d596d0165599d76f501d8ae6ebcaec99
+  metadata.gz: f1cb4c51f185f9898115c38743f5b83964442be4b14381f7cdb45b1bb75da1698ef8b918c053a6f9df4c5b9fed7058614e12a6bed1baf43a44813c16396e26e7
+  data.tar.gz: 510b721af05b438f4f72791a3e78c49e97be680912f21fd1ca59064e59f72191f27cc3a6058d86d68b97445c15d7ca65091a1bd51de0bc50da2bfb51c4567efc

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 ## [Unreleased]
 
+## [0.2.0] - 2026-07-20
+
+### Added
+
+- `Node` form actions: `value`/`attribute`, `at_css` (scoped `querySelector`),
+  `focus`, `type` (sets value and fires `input`/`change`, since Obscura has no
+  Input domain), and `submit` (raising `ProtocolError` for a node with no form).
+- `Frame#to_node` is now public so `Node#at_css` reuses the same node
+  resolution.
+
 ## [0.1.1] - 2026-07-14
 
 ### Fixed

data/lib/obxcura/client.rb

@@ -110,6 +110,7 @@ module Obxcura
       @closing = true
       @driver&.close
       @socket&.close
+      @subscribers.clear
       @reader&.kill
     rescue IOError, SystemCallError
       nil

data/lib/obxcura/frame/dom.rb

@@ -46,9 +46,8 @@ module Obxcura
           .filter_map { |stub| to_node(stub) }
       end
 
-      private
-
       # Resolve Obscura's serialized node stub ({"_nid"=>N,...}) into a Node.
+      # Public so {Node#at_css} can reuse the same resolution path.
       #
       # @param stub [Hash, nil] the serialized node from a querySelector call.
       # @return [Obxcura::Node, nil] a live node handle, or nil for a blank match.

data/lib/obxcura/node.rb

@@ -5,19 +5,34 @@ module Obxcura
   # reads run as function calls bound to that object and reflect the current DOM.
   # Returned by Frame::DOM#at_css / #css.
   class Node
-    # @return [String] the CDP remote objectId backing this node.
-    attr_reader :object_id
+    # @return [String] the CDP remote objectId backing this node. Named
+    # `remote_object_id` (not `object_id`) so it doesn't shadow Ruby's
+    # `Object#object_id`, which every object relies on for identity.
+    attr_reader :remote_object_id
 
     # @param frame [Obxcura::Frame] the frame the node lives in.
     # @param object_id [String] the CDP objectId of the node.
     def initialize(frame, object_id)
       @frame = frame
-      @object_id = object_id
+      @remote_object_id = object_id
     end
 
     # @return [String] the visible text of the node and its descendants.
     def text
-      @frame.call_on(@object_id, "function() { return this.textContent; }")
+      @frame.call_on(remote_object_id, "function() { return this.textContent; }")
+    end
+
+    # @return [String, nil] the node's `value` (form controls), or nil.
+    def value
+      @frame.call_on(remote_object_id, "function() { return this.value; }")
+    end
+
+    # First descendant matching a CSS selector, searched within this node.
+    #
+    # @param selector [String] a CSS selector.
+    # @return [Obxcura::Node, nil] the matching node, or nil if none.
+    def at_css(selector)
+      @frame.to_node(@frame.call_on(remote_object_id, "function(s) { return this.querySelector(s); }", [ selector ]))
     end
 
     # Read an attribute value.
@@ -25,12 +40,58 @@ module Obxcura
     # @param name [String] the attribute name.
     # @return [String, nil] the attribute value, or nil if absent.
     def [](name)
-      @frame.call_on(@object_id, "function(name) { return this.getAttribute(name); }", [ name ])
+      @frame.call_on(remote_object_id, "function(name) { return this.getAttribute(name); }", [ name ])
+    end
+    alias attribute []
+
+    # Give this node keyboard focus.
+    #
+    # @return [self]
+    def focus
+      tap { @frame.page.command("DOM.focus", objectId: remote_object_id) }
+    end
+
+    # Type text into this node. Obscura has no Input domain (Input.insertText /
+    # dispatchKeyEvent are unimplemented), so this sets `value` in page context
+    # and fires the `input`/`change` events real typing would, letting listeners
+    # react. Appends, matching keyboard behaviour when the node already has text.
+    #
+    # @param keys [Array<String>] text fragments to type (joined).
+    # @return [self]
+    def type(*keys)
+      tap { @frame.call_on(remote_object_id, <<~JS, [ keys.join ])
+        function(text) {
+          this.value = (this.value || "") + text;
+          this.dispatchEvent(new Event("input", { bubbles: true }));
+          this.dispatchEvent(new Event("change", { bubbles: true }));
+        }
+      JS
+      }
+    end
+
+    # Submit this node's form. Works whether the node is the `<form>` itself or a
+    # control inside one (resolved via `.form` / closest `<form>`). Prefers
+    # `requestSubmit` (runs validation and fires the submit event) and falls back
+    # to `submit` where it's unavailable.
+    #
+    # @return [self]
+    # @raise [Obxcura::ProtocolError] if the node isn't a form or inside one.
+    def submit
+      result = @frame.call_on(remote_object_id, <<~JS)
+        function() {
+          const form = this.tagName === "FORM" ? this : (this.form || this.closest("form"));
+          if (!form) return { error: "node is not a form and has no ancestor form" };
+          form.requestSubmit ? form.requestSubmit() : form.submit();
+        }
+      JS
+      raise ProtocolError, result["error"] if result.is_a?(Hash) && result["error"]
+
+      self
     end
 
     # @return [String] the node's serialized outer HTML.
     def outer_html
-      @frame.call_on(@object_id, "function() { return this.outerHTML; }")
+      @frame.call_on(remote_object_id, "function() { return this.outerHTML; }")
     end
   end
 end

data/lib/obxcura/page.rb

@@ -67,7 +67,7 @@ module Obxcura
     # @return [Obxcura::Page, nil] the page, removed from the browser.
     def close
       @client.unsubscribe(@session_id)
-      @client.command("Network.clearBrowserCookies", { targetId: @target_id })
+      # @client.command("Network.clearBrowserCookies", { targetId: @target_id })
       @client.command("Target.closeTarget", { targetId: @target_id })
     rescue ProtocolError
       # Target already gone — nothing to do.

data/lib/obxcura/version.rb

@@ -4,5 +4,5 @@ module Obxcura
   # The gem's semantic version string.
   #
   # @return [String]
-  VERSION = "0.1.1"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: obxcura
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - memoxmrdl
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-15 00:00:00.000000000 Z
+date: 2026-07-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: websocket-driver