playwright-ruby-client 1.61.0 → 1.63.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c45763ab237c198b8f2aa3afa3114ae0bf821481e57711516f5014547079f183
-  data.tar.gz: ed8d42f43cb28c8ae2a45755332582b6e51ac993a751de94fb1a25fff43f5532
+  metadata.gz: 275e62d0e3c798dd08cdb59a52299af990f93b7fd5fe1cf2a1f9b1c5441a1680
+  data.tar.gz: 1711ed5665344b5c52b6f45c2621e03e2ac8983d698e6717303cad3bbb80659b
 SHA512:
-  metadata.gz: 90ac4618f354ca98c4d5a5c7284b23d752a098bf7128a246076964381f36d93680b78c89599b15b175afdb7274e6cea1882cfab64f9d9eab6dcb1317b0f0f894
-  data.tar.gz: 91cdfb64498f4e76f0f3a6f726fd49fa3d36dd7c6b692e843455bf8a9160a94216f13e324ffe90a2472c0b9ad573bd1d1ab241590629357d01562991ea299c63
+  metadata.gz: 9180d7ceb51f46c828e8a08aaffdd1e813bc57b842f268556990030a9003686841842cd8d3f5c98ea8b5c2ea3e6fdb63a4ff45afb6e44adb2b2a9a6c7c6ef861
+  data.tar.gz: 5efd8cd40f2e8b5d2cf2e22943ae6df4e3791b66874ca3cb0f72bbb66a1bd50442e8e481c990eed9fe958f4bfe82102e58634c5bfd2bc1823a0ff25b16036bbf

data/README.md

@@ -12,25 +12,22 @@ gem 'playwright-ruby-client'
 
 and then 'bundle install'.
 
-Since playwright-ruby-client doesn't include the playwright driver, **we have to install [playwright](https://github.com/microsoft/playwright) in advance**.
+Since playwright-ruby-client doesn't include Playwright, **we have to install Node.js and a compatible version of [playwright-core](https://www.npmjs.com/package/playwright-core) in advance**.
 
+```sh
+PLAYWRIGHT_CLI_VERSION=$(bundle exec ruby -e 'require "playwright/version"; puts Playwright::COMPATIBLE_PLAYWRIGHT_VERSION')
+npm install "playwright-core@$PLAYWRIGHT_CLI_VERSION"
+./node_modules/.bin/playwright-core install
 ```
-npm install playwright
-./node_modules/.bin/playwright install
-```
-
-And set `playwright_cli_executable_path: './node_modules/.bin/playwright'`
 
-**Prefer playwrighting without Node.js?**
-
-Instead of npm, you can also directly download playwright driver from playwright.azureedge.net/builds/. The URL can be easily detected from [here](https://github.com/microsoft/playwright-python/blob/cb5409934629adaabc0cff1891080de2052fa778/setup.py#L73-L77)
+And set `playwright_cli_executable_path: './node_modules/.bin/playwright-core'`.
 
 ### Capture a site
 
 ```ruby
 require 'playwright'
 
-Playwright.create(playwright_cli_executable_path: './node_modules/.bin/playwright') do |playwright|
+Playwright.create(playwright_cli_executable_path: './node_modules/.bin/playwright-core') do |playwright|
   playwright.chromium.launch(headless: false) do |browser|
     page = browser.new_page
     page.goto('https://github.com/YusukeIwaki')
@@ -46,7 +43,7 @@ end
 ```ruby
 require 'playwright'
 
-Playwright.create(playwright_cli_executable_path: './node_modules/.bin/playwright') do |playwright|
+Playwright.create(playwright_cli_executable_path: './node_modules/.bin/playwright-core') do |playwright|
   playwright.chromium.launch(headless: false) do |browser|
     page = browser.new_page
     page.goto('https://github.com/')
@@ -94,7 +91,7 @@ $ bundle exec ruby main.rb
 ```ruby
 require 'playwright'
 
-Playwright.create(playwright_cli_executable_path: './node_modules/.bin/playwright') do |playwright|
+Playwright.create(playwright_cli_executable_path: './node_modules/.bin/playwright-core') do |playwright|
   devices = playwright.android.devices
   unless devices.empty?
     device = devices.last
@@ -128,12 +125,10 @@ end
 We have to download android-driver for Playwright in advance.
 
 ```
-wget https://github.com/microsoft/playwright/raw/master/bin/android-driver-target.apk -O /path/to/playwright-driver/package/bin/android-driver-target.apk
-wget https://github.com/microsoft/playwright/raw/master/bin/android-driver.apk -O /path/to/playwright-driver/package/bin/android-driver.apk
+wget https://github.com/microsoft/playwright/raw/master/bin/android-driver-target.apk -O ./node_modules/playwright-core/bin/android-driver-target.apk
+wget https://github.com/microsoft/playwright/raw/master/bin/android-driver.apk -O ./node_modules/playwright-core/bin/android-driver.apk
 ```
 
-(If you downloaded Playwright via npm, replace `/path/to/playwright-driver/package/` with `./node_modules/playwright/` above.)
-
 ```ruby
 require 'playwright'
 
@@ -168,7 +163,7 @@ If your environment doesn't accept installing browser or creating browser proces
 For launching Playwright server, just execute:
 
 ```
-npx playwright install && npx playwright run-server --port 8080 --path /ws
+./node_modules/.bin/playwright-core install && ./node_modules/.bin/playwright-core run-server --port 8080 --path /ws
 ```
 
 and we can connect to the server with the code like this:

data/documentation/docs/api/api_request_context.md

@@ -298,3 +298,6 @@ The method will populate request cookies from the context and update
 context cookies from the response. The method will automatically follow redirects.
 
 ## tracing
+
+
+Tracing recorder for requests made through this API request context.

data/documentation/docs/api/api_response.md

@@ -122,6 +122,18 @@ def text
 
 Returns the text representation of response body.
 
+## timing
+
+```
+def timing
+```
+
+
+Returns resource timing information for given response. For redirected requests, returns the information for the last
+request in the redirect chain. When the response is served [from the HAR file](https://playwright.dev/python/docs/mock#replaying-from-har), timing
+information is not available and all the values are -1. Find more information at
+[Resource Timing API](https://developer.mozilla.org/en-US/docs/Web/API/PerformanceResourceTiming).
+
 ## url
 
 ```

data/documentation/docs/api/browser_context.md

@@ -434,11 +434,11 @@ alias: `offline=`
 ## storage_state
 
 ```
-def storage_state(indexedDB: nil, path: nil)
+def storage_state(credentials: nil, indexedDB: nil, opfs: nil, path: nil)
 ```
 
 
-Returns storage state for this browser context, contains current cookies, local storage snapshot and IndexedDB snapshot.
+Returns storage state for this browser context, contains current cookies, local storage snapshot, IndexedDB snapshot, origin private file system snapshot and virtual WebAuthn credentials.
 
 ## set_storage_state
 
@@ -448,7 +448,9 @@ def set_storage_state(storageState)
 alias: `storage_state=`
 
 
-Clears the existing cookies, local storage and IndexedDB entries for all origins and sets the new storage state.
+Clears the existing cookies, local storage, IndexedDB entries, origin private file system entries and virtual WebAuthn credentials, and sets the new storage
+state. When the storage state contains credentials, the virtual WebAuthn authenticator is installed (equivalent to
+[Credentials#install](./credentials#install)), preventing all real authenticators from working in this context.
 
 **Usage**
 

data/documentation/docs/api/browser_type.md

@@ -59,6 +59,8 @@ The default browser context is accessible via [Browser#contexts](./browser#conte
 
 **NOTE**: This connection is significantly lower fidelity than the Playwright protocol connection via [BrowserType#connect](./browser_type#connect). If you are experiencing issues or attempting to use advanced functionality, you probably want to use [BrowserType#connect](./browser_type#connect).
 
+**NOTE**: Playwright maintains a curated list of arguments for launching the browser. If you launch the browser without Playwright and do not pass the exact same arguments, some of Playwright functionality may be broken upon connecting to the browser.
+
 **Usage**
 
 ```ruby

data/documentation/docs/api/credentials.md

@@ -9,7 +9,7 @@ sidebar_position: 10
 register passkeys and answer `navigator.credentials.create()` / `navigator.credentials.get()`
 ceremonies in the page, without a real authenticator or hardware security key.
 
-There are two common ways to use it:
+There are three common ways to use it:
 
 **Usage: seed a known credential**
 
@@ -31,7 +31,7 @@ page.goto("https://example.com/login")
 # The page's navigator.credentials.get() is answered with the seeded passkey.
 ```
 
-**Usage: capture a passkey, then reuse it**
+**Usage: capture a credential, then reuse it**
 
 ```ruby
 # setup test: let the app register a passkey, then save it.
@@ -65,6 +65,10 @@ page.goto("https://example.com/login")
 # navigator.credentials.get() resolves the captured passkey - already signed in.
 ```
 
+**Usage: save credentials in the storage state, restore later**
+
+See [authentication guide](https://playwright.dev/python/docs/auth) for examples of using saving and resotring the storage state.
+
 **Defaults**
 
 ## install

data/documentation/docs/api/element_handle.md

@@ -75,6 +75,7 @@ def check(
       force: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       timeout: nil,
       trial: nil)
 ```
@@ -103,6 +104,7 @@ def click(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       steps: nil,
       timeout: nil,
       trial: nil)
@@ -139,6 +141,7 @@ def dblclick(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       steps: nil,
       timeout: nil,
       trial: nil)
@@ -290,6 +293,7 @@ def hover(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       timeout: nil,
       trial: nil)
 ```
@@ -538,6 +542,7 @@ def set_checked(
       force: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       timeout: nil,
       trial: nil)
 ```
@@ -578,6 +583,7 @@ def tap_point(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       timeout: nil,
       trial: nil)
 ```
@@ -630,6 +636,7 @@ def uncheck(
       force: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       timeout: nil,
       trial: nil)
 ```

data/documentation/docs/api/frame.md

@@ -58,6 +58,7 @@ def check(
       force: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)
@@ -95,6 +96,7 @@ def click(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)
@@ -131,6 +133,7 @@ def dblclick(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)
@@ -202,6 +205,7 @@ def drag_and_drop(
       target,
       force: nil,
       noWaitAfter: nil,
+      scroll: nil,
       sourcePosition: nil,
       steps: nil,
       strict: nil,
@@ -387,13 +391,17 @@ puts frame == content_frame # => true
 ## frame_locator
 
 ```
-def frame_locator(selector)
+def frame_locator(selector = nil)
 ```
 
 
 When working with iframes, you can create a frame locator that will enter the iframe and allow selecting elements
 in that iframe.
 
+When called without `selector`, the search starts in this frame or in any of the iframes inside it,
+so that you don't need to locate each iframe first. Note that the rest of the locator is resolved inside a single
+frame, just like any other locator. If it matches elements inside multiple frames, an error is thrown.
+
 **Usage**
 
 Following snippet locates element with text "Submit" in the iframe with id `my-frame`, like `<iframe id="my-frame">`:
@@ -403,6 +411,13 @@ locator = frame.frame_locator("#my-iframe").get_by_text("Submit")
 locator.click
 ```
 
+Following snippet locates a button, either in the frame or in one of the iframes inside it:
+
+```ruby
+locator = frame.frame_locator.get_by_role('button')
+locator.click
+```
+
 ## get_attribute
 
 ```
@@ -671,6 +686,7 @@ def hover(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)
@@ -932,6 +948,7 @@ def set_checked(
       force: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)
@@ -987,6 +1004,7 @@ def tap_point(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)
@@ -1056,6 +1074,7 @@ def uncheck(
       force: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)

data/documentation/docs/api/frame_locator.md

@@ -24,6 +24,26 @@ page.locator('.result-frame').content_frame.get_by_role('button').click
 page.locator('.result-frame').first.content_frame.get_by_role('button').click
 ```
 
+**Any frame**
+
+Calling [Page#frame_locator](./page#frame_locator) or [Frame#frame_locator](./frame#frame_locator) without a selector creates a frame locator that
+starts the search in any frame of the subtree - so that you don't
+need to locate the iframe first.
+
+```ruby
+# Finds the button in any frame on the page:
+page.frame_locator.get_by_role('button').click
+
+# Finds the iframe anywhere on the page and clicks the button inside it:
+page.frame_locator.locator('#my-frame').content_frame.get_by_role('button').click
+```
+
+Only the start of the search is affected - the rest of the locator is resolved inside a single frame, just like any
+other locator. Following the strictness rules above, an error is thrown when elements are matched in multiple frames.
+
+Such a frame locator does not point to a particular `iframe`, so [FrameLocator#owner](./frame_locator#owner),
+[FrameLocator#first](./frame_locator#first), [FrameLocator#last](./frame_locator#last) and [FrameLocator#nth](./frame_locator#nth) are not supported on it.
+
 **Converting Locator to FrameLocator**
 
 If you have a [Locator](./locator) object pointing to an `iframe` it can be converted to [FrameLocator](./frame_locator) using [Locator#content_frame](./locator#content_frame).

data/documentation/docs/api/locator.md

@@ -179,6 +179,7 @@ def check(
       force: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       timeout: nil,
       trial: nil)
 ```
@@ -238,6 +239,7 @@ def click(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       steps: nil,
       timeout: nil,
       trial: nil)
@@ -300,6 +302,7 @@ def dblclick(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       steps: nil,
       timeout: nil,
       trial: nil)
@@ -410,6 +413,7 @@ def drag_to(
       target,
       force: nil,
       noWaitAfter: nil,
+      scroll: nil,
       sourcePosition: nil,
       steps: nil,
       targetPosition: nil,
@@ -921,6 +925,7 @@ def hover(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       timeout: nil,
       trial: nil)
 ```
@@ -1367,6 +1372,7 @@ def set_checked(
       force: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       timeout: nil,
       trial: nil)
 ```
@@ -1438,6 +1444,7 @@ def tap_point(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       timeout: nil,
       trial: nil)
 ```
@@ -1496,6 +1503,7 @@ def uncheck(
       force: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       timeout: nil,
       trial: nil)
 ```
@@ -1523,6 +1531,34 @@ If the element is detached from the DOM at any moment during the action, this me
 When all steps combined have not finished during the specified `timeout`, this method throws a
 `TimeoutError`. Passing zero timeout disables this.
 
+## visible
+
+```
+def visible
+```
+
+
+Returns a locator that matches only [visible](https://playwright.dev/python/docs/actionability#visible) elements, ignoring the invisible ones. This is the recommended way to distinguish elements by visibility, as opposed to the `:visible` CSS pseudo-class.
+
+Note that visibility is checked every time the locator is used, and not at the moment of the [Locator#visible](./locator#visible) call.
+
+**Usage**
+
+Consider a page with two buttons, the first invisible and the second visible.
+
+```html
+<button style='display: none'>Invisible</button>
+<button>Visible</button>
+```
+
+This will only find the second button, because it is visible, and then click it.
+
+```ruby
+page.locator('button').visible.click
+```
+
+To match invisible elements instead, use [Locator#filter](./locator#filter) with the `visible` option set to `false`.
+
 ## wait_for
 
 ```
@@ -1541,3 +1577,24 @@ If target element already satisfies the condition, the method returns immediatel
 order_sent = page.locator("#order-sent")
 order_sent.wait_for
 ```
+
+## wait_for_function
+
+```
+def wait_for_function(expression, arg: nil, timeout: nil)
+```
+
+
+Returns when `expression` returns a truthy value, called with the matching element as a first argument, and `arg` as a second argument.
+
+This is a generic way to wait for an element to reach a custom condition without asserting it. The locator is re-resolved on each retry, so it tolerates the element being re-rendered while waiting.
+
+If `expression` returns a [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise), this method will wait for the promise to resolve before checking its value.
+
+If `expression` throws or rejects, this method throws.
+
+**Usage**
+
+Wait for an attribute to appear:
+
+Passing argument to `expression`:

data/documentation/docs/api/locator_assertions.md

@@ -164,7 +164,7 @@ The opposite of [LocatorAssertions#to_have_accessible_name](./locator_assertions
 ## not_to_have_attribute
 
 ```ruby
-expect(locator).not_to have_attribute(name, value, ignoreCase: nil, timeout: nil)
+expect(locator).not_to have_attribute(name, value: nil, ignoreCase: nil, timeout: nil)
 ```
 
 
@@ -587,7 +587,7 @@ expect(locator).to have_accessible_name("Save to disk")
 ## to_have_attribute
 
 ```ruby
-expect(locator).to have_attribute(name, value, ignoreCase: nil, timeout: nil)
+expect(locator).to have_attribute(name, value: nil, ignoreCase: nil, timeout: nil)
 ```
 
 
@@ -598,6 +598,8 @@ Ensures the [Locator](./locator) points to an element with given attribute.
 ```ruby
 locator = page.locator("input")
 expect(locator).to have_attribute("type", "text")
+expect(locator).to have_attribute("disabled")
+expect(locator).not_to have_attribute("readonly")
 ```
 
 ## to_have_class

data/documentation/docs/api/page.md

@@ -112,6 +112,7 @@ def check(
       force: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)
@@ -141,6 +142,7 @@ def click(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)
@@ -201,6 +203,7 @@ def dblclick(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)
@@ -275,6 +278,7 @@ def drag_and_drop(
       target,
       force: nil,
       noWaitAfter: nil,
+      scroll: nil,
       sourcePosition: nil,
       steps: nil,
       strict: nil,
@@ -581,13 +585,17 @@ frame = page.frame(url: /.*domain.*/)
 ## frame_locator
 
 ```
-def frame_locator(selector)
+def frame_locator(selector = nil)
 ```
 
 
 When working with iframes, you can create a frame locator that will enter the iframe and allow selecting elements
 in that iframe.
 
+When called without `selector`, the search starts in any frame on the page - the main frame or any of
+the iframes - so that you don't need to locate each iframe first. Note that the rest of the locator is resolved
+inside a single frame, just like any other locator. If it matches elements inside multiple frames, an error is thrown.
+
 **Usage**
 
 Following snippet locates element with text "Submit" in the iframe with id `my-frame`,
@@ -598,6 +606,13 @@ locator = page.frame_locator("#my-iframe").get_by_text("Submit")
 locator.click
 ```
 
+Following snippet locates a button, either in the main frame or in one of the iframes:
+
+```ruby
+locator = page.frame_locator.get_by_role('button')
+locator.click
+```
+
 ## frames
 
 ```
@@ -851,6 +866,9 @@ last redirect. If cannot go back, returns `null`.
 
 Navigate to the previous page in history.
 
+**NOTE**: **Testing Back/Forward Cache (BFCache) is not supported.**
+By default, Playwright disables the Back/Forward Cache across all browsers. Even if explicitly enabled, Playwright's internal state relies on network-level navigation events. Because BFCache restores unfreeze the DOM without firing these events, using `page.goBack()` or `page.goForward()` to trigger a BFCache restore will result in timeouts and a desynchronized [Page](./page) state.
+
 ## go_forward
 
 ```
@@ -863,6 +881,9 @@ last redirect. If cannot go forward, returns `null`.
 
 Navigate to the next page in history.
 
+**NOTE**: **Testing Back/Forward Cache (BFCache) is not supported.**
+By default, Playwright disables the Back/Forward Cache across all browsers. Even if explicitly enabled, Playwright's internal state relies on network-level navigation events. Because BFCache restores unfreeze the DOM without firing these events, using `page.goBack()` or `page.goForward()` to trigger a BFCache restore will result in timeouts and a desynchronized [Page](./page) state.
+
 ## goto
 
 ```
@@ -908,6 +929,7 @@ def hover(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)
@@ -1416,6 +1438,7 @@ def set_checked(
       force: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)
@@ -1546,6 +1569,7 @@ def tap_point(
       modifiers: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)
@@ -1615,6 +1639,7 @@ def uncheck(
       force: nil,
       noWaitAfter: nil,
       position: nil,
+      scroll: nil,
       strict: nil,
       timeout: nil,
       trial: nil)

data/documentation/docs/api/playwright.md

@@ -11,7 +11,7 @@ to drive automation:
 ```ruby
 require 'playwright'
 
-Playwright.create(playwright_cli_executable_path: 'npx playwright') do |playwright|
+Playwright.create(playwright_cli_executable_path: './node_modules/.bin/playwright-core') do |playwright|
   chromium = playwright.chromium # or "firefox" or "webkit".
   chromium.launch do |browser|
     page = browser.new_page
@@ -36,7 +36,7 @@ Returns a dictionary of devices to be used with [Browser#new_context](./browser#
 ```ruby
 require 'playwright'
 
-Playwright.create(playwright_cli_executable_path: 'npx playwright') do |playwright|
+Playwright.create(playwright_cli_executable_path: './node_modules/.bin/playwright-core') do |playwright|
   iphone = playwright.devices["iPhone 6"]
   playwright.webkit.launch do |browser|
     context = browser.new_context(**iphone)

data/documentation/docs/api/tracing.md

@@ -26,9 +26,11 @@ end
 
 ```
 def start(
+      ariaSnapshots: nil,
       live: nil,
       name: nil,
       screenshots: nil,
+      screenSnapshots: nil,
       snapshots: nil,
       sources: nil,
       title: nil)
@@ -86,7 +88,7 @@ def start_har(path, content: nil, mode: nil, urlFilter: nil)
 
 Start recording a HAR (HTTP Archive) of network activity in this context. The HAR file is written to disk when [Tracing#stop_har](./tracing#stop_har) is called, or when the returned `Disposable` is disposed.
 
-Only one HAR recording can be active at a time per [BrowserContext](./browser_context).
+Only one HAR recording can be active at a time per [Tracing](./tracing) instance.
 
 **Usage**