feat: add PageExplorer.current_url

src/page_explorer/page_explorer.py

@@ -177,6 +177,20 @@ def close_browser(self, wait: int = 0, poll: float = 0.5) -> None:
                     break
                 sleep(poll)
 
+    @property
+    def current_url(self) -> str | None:
+        """Gets the URL of the current path.
+
+        Args:
+            None
+
+        Returns:
+            The URL if it is available otherwise None.
+        """
+        with suppress(HTTPError, WebDriverException):
+            return self._driver.current_url
+        return None
+
     # pylint: disable=too-many-branches
     def explore(
         self,
@@ -281,10 +295,9 @@ def is_connected(self) -> bool:
         Returns:
             True if a page is open and connection is active otherwise False.
         """
-        try:
+        with suppress(HTTPError, WebDriverException):
             return isinstance(self._driver.title, str)
-        except (HTTPError, WebDriverException):
-            LOG.debug("connection has closed")
+        LOG.debug("connection has closed")
         return False
 
     def shutdown(self) -> None:

src/page_explorer/test_page_explorer.py

@@ -59,6 +59,24 @@ def test_page_explorer_is_connected(mocker, title_effect, result):
         assert exp.is_connected() == result
 
 
+@mark.parametrize(
+    "url_effect, result",
+    (
+        # connected
+        (("foo",), "foo"),
+        # not connected
+        ((WebDriverException("test"),), None),
+    ),
+)
+def test_page_explorer_current_url(mocker, url_effect, result):
+    """test PageExplorer.current_url"""
+    driver = mocker.patch("page_explorer.page_explorer.FirefoxDriver", autospec=True)
+    type(driver.return_value).current_url = mocker.PropertyMock(side_effect=url_effect)
+
+    with PageExplorer("bin", 1234) as exp:
+        assert exp.current_url == result
+
+
 @mark.parametrize(
     "title_calls, title_effect, script_effect",
     (