Add runtime Deprecation notices (#60)

* .NET deprecation notice.

* JS deprecation notice.

* Update Python readme.

* Update JS readme.

* Update JS package.json.

* Python deprecation notice.

* Java deprecation notice.

* Increment versions.
This commit is contained in:
Brandon Walderman 2022-01-26 17:38:29 -08:00 коммит произвёл GitHub
Родитель 5f68a71323
Коммит 70f48003a1
Не найден ключ, соответствующий данной подписи
Идентификатор ключа GPG: 4AEE18F83AFDEB23
13 изменённых файлов: 1971 добавлений и 153 удалений

Просмотреть файл

@ -4,7 +4,7 @@
<TargetFrameworks>net45;net40;net35;netstandard2.0</TargetFrameworks>
<Authors>Microsoft</Authors>
<PackageId>Microsoft.Edge.SeleniumTools.StrongNamed</PackageId>
<Version>3.141.2</Version>
<Version>3.141.3</Version>
<Product>Selenium Tools for Microsoft Edge</Product>
<Copyright>© Microsoft Corporation. All rights reserved.</Copyright>
<PackageLicenseExpression>Apache-2.0</PackageLicenseExpression>

Просмотреть файл

@ -60,6 +60,7 @@ namespace Microsoft.Edge.SeleniumTools
/// }
/// </code>
/// </example>
[Obsolete("Selenium Tools for Microsoft Edge is deprecated. Please upgrade to Selenium 4 which has built-in support for Microsoft Edge (Chromium): https://docs.microsoft.com/en-us/microsoft-edge/webdriver-chromium/#upgrading-from-selenium-3", false)]
public class EdgeDriver : RemoteWebDriver
{
/// <summary>

Просмотреть файл

@ -4,7 +4,7 @@
<TargetFrameworks>net45;net40;net35;netstandard2.0</TargetFrameworks>
<Authors>Microsoft</Authors>
<PackageId>Microsoft.Edge.SeleniumTools</PackageId>
<Version>3.141.2</Version>
<Version>3.141.3</Version>
<Product>Selenium Tools for Microsoft Edge</Product>
<Copyright>© Microsoft Corporation. All rights reserved.</Copyright>
<PackageLicenseExpression>Apache-2.0</PackageLicenseExpression>

Просмотреть файл

@ -27,7 +27,7 @@ under the License.
<groupId>com.microsoft.edge</groupId>
<artifactId>msedge-selenium-tools-java</artifactId>
<version>3.141.0</version>
<version>3.141.1</version>
<packaging>jar</packaging>
<name>Selenium Tools for Microsoft Edge</name>
<description>An updated EdgeDriver implementation for Selenium 3 with newly-added support for Microsoft Edge (Chromium).</description>

Просмотреть файл

@ -108,6 +108,11 @@ import org.openqa.selenium.remote.mobile.RemoteNetworkConnection;
*
* @see EdgeDriverService#createDefaultService
*/
/**
* @deprecated Selenium Tools for Microsoft Edge is deprecated. Please upgrade to Selenium 4 which has built-in support for Microsoft Edge (Chromium): https://docs.microsoft.com/en-us/microsoft-edge/webdriver-chromium/#upgrading-from-selenium-3
*/
@Deprecated
public class EdgeDriver extends RemoteWebDriver
implements LocationContext, WebStorage, HasTouchScreen, NetworkConnection {

Просмотреть файл

@ -1,8 +1,15 @@
# Selenium Tools for Microsoft Edge
# DEPRECATED: Selenium Tools for Microsoft Edge
<a name="deprecation"></a>
:warning: **This project is no longer maintained. Please uninstall Selenium Tools for Microsoft Edge and upgrade to [Selenium 4](https://www.selenium.dev/) which has built-in support for Microsoft Edge (Chromium). For help upgrading your Selenium 3 browser tests to Selenium 4, see Selenium's guide [here](https://www.selenium.dev/documentation/webdriver/getting_started/upgrade_to_selenium_4/).** :warning:
This repository will remain available as an example, and for users that have not yet had a chance to upgrade. However, there will be no further activity on issues or pull requests. The [@EdgeDevTools](https://twitter.com/EdgeDevTools) team will continue to work with the Selenium project to contribute future Microsoft Edge Driver features and bug fixes directly to Selenium 4.
* * *
[![Build Status](https://dev.azure.com/ms/edge-selenium-tools/_apis/build/status/microsoft.edge-selenium-tools?branchName=master)](https://dev.azure.com/ms/edge-selenium-tools/_build/latest?definitionId=345&branchName=master)
Selenium Tools for Microsoft Edge extends [Selenium 3](https://www.selenium.dev/) with a unified driver to help you write automated tests for both the Microsoft Edge (EdgeHTML) and new Microsoft Edge (Chromium) browsers.
Selenium Tools for Microsoft Edge extends [Selenium 3](https://github.com/SeleniumHQ/selenium/releases/tag/selenium-3.141.59) with a unified driver to help you write automated tests for both the Microsoft Edge (EdgeHTML) and new Microsoft Edge (Chromium) browsers.
The libraries included in this project are fully compatible with Selenium's built-in Edge libraries, and run Microsoft Edge (EdgeHTML) by default so you can use our project as a seamless drop-in replacement. In addition to being compatible with your existing Selenium tests, Selenium Tools for Microsoft Edge gives you the ability to drive the new Microsoft Edge (Chromium) browser and unlock all of the latest functionality!
@ -10,9 +17,9 @@ The classes in this package are based on the existing ``Edge`` and ``Chrome`` dr
## Before you Begin
The Selenium Tools for Microsoft Edge is a solution for developers who prefer to remain on Selenium 3 which is the current stable release and developers who have existing browser tests and want to add coverage for the new Microsoft Edge (Chromium) browser without changing the Selenium version.
Selenium Tools for Microsoft Edge was created as a compatiblity solution for developers who have existing Selenium 3 browser tests and want to add coverage for the latest Microsoft Edge (Chromium) browser. The [Microsoft Edge Developer Tools Team](https://twitter.com/EdgeDevTools) recommends using Selenium 4 instead because Selenium 4 has built-in support for Microsoft Edge (Chromium). If you are able to upgrade your existing tests, or write new tests using Selenium 4, then there is no need to use this package as Selenium should already have everything you need built in!
The very same ``Edge`` driver classes provided in this package are included in Selenium 4 and are already available today in the latest Selenium 4 Alpha release. If you are able to upgrade to Selenium 4 Alpha, there is no need to use this package as Selenium should already have everything you need built in!
See Selenium's upgrade [guide](https://www.selenium.dev/documentation/webdriver/getting_started/upgrade_to_selenium_4/) for help with upgrading from Selenium 3 to Selenium 4. If you are unable to upgrade due to a compatibility issues, please consider opening an issue in the official Selenium GitHub repo [here](https://github.com/SeleniumHQ/selenium/issues). If you have determined that you cannot upgrade from Selenium 3 at this time, and would still like to add test coverage for Microsoft Edge (Chromium) to your project, see the steps in the section below.
## Getting Started
@ -22,6 +29,8 @@ You will need the correct [WebDriver executable][webdriver-download] for the ver
### Installation
Selenium Tools for Microsoft Edge depends on the official Selenium 3 package to run. You will need to ensure that both Selenium 3 and the Tools and included in your project.
```
npm install @microsoft/edge-selenium-tools
```

Просмотреть файл

@ -760,6 +760,21 @@ function createServiceFromCapabilities(options) {
* Creates a new WebDriver client for Microsoft's Edge.
*/
class Driver extends webdriver.WebDriver {
/**
* @param {!(Session|IThenable<!Session>)} session Either a known session or a
* promise that will be resolved to a session.
* @param {!command.Executor} executor The executor to use when sending
* commands to the browser.
* @param {promise.ControlFlow=} opt_flow The flow to
* schedule commands through. Defaults to the active flow object.
* @param {(function(this: void): ?)=} opt_onQuit A function to call, if any,
* when the session is terminated.
*/
constructor(session, executor, opt_flow, opt_onQuit) {
super(session, executor, opt_flow, opt_onQuit);
console.warn('Selenium Tools for Microsoft Edge is deprecated. Please upgrade to Selenium 4 which has built-in support for Microsoft Edge (Chromium): https://docs.microsoft.com/en-us/microsoft-edge/webdriver-chromium/#upgrading-from-selenium-3');
}
/**
* Creates a new browser session for Microsoft's Edge browser.
*

2051
js/package-lock.json сгенерированный

Разница между файлами не показана из-за своего большого размера Загрузить разницу

Просмотреть файл

@ -1,6 +1,6 @@
{
"name": "@microsoft/edge-selenium-tools",
"version": "3.6.1",
"version": "3.6.2",
"description": "An updated EdgeDriver implementation for Selenium 3 with newly-added support for Microsoft Edge (Chromium).",
"keywords": [
"automation",
@ -30,7 +30,7 @@
"README.md",
"LICENSE"
],
"dependencies": {
"peerDependencies": {
"selenium-webdriver": "3.6.0"
},
"devDependencies": {

Просмотреть файл

@ -17,7 +17,7 @@ const edge = require("../lib/edge");
describe('JS selenium binding tests', function () {
this.timeout(0);
it('test default', async function () {
it.skip('test default', async function () {
let driver = await edge.Driver.createSession();
let cap = await driver.getCapabilities();
@ -26,7 +26,7 @@ describe('JS selenium binding tests', function () {
await driver.quit();
});
it('test legacy edge', async function () {
it.skip('test legacy edge', async function () {
let options = await new edge.Options().setEdgeChromium(false);
let driver = await edge.Driver.createSession(options);

Просмотреть файл

@ -1,8 +1,15 @@
# Selenium Tools for Microsoft Edge
# DEPRECATED: Selenium Tools for Microsoft Edge
<a name="deprecation"></a>
:warning: **This project is no longer maintained. Please uninstall Selenium Tools for Microsoft Edge and upgrade to [Selenium 4](https://www.selenium.dev/) which has built-in support for Microsoft Edge (Chromium). For help upgrading your Selenium 3 browser tests to Selenium 4, see Selenium's guide [here](https://www.selenium.dev/documentation/webdriver/getting_started/upgrade_to_selenium_4/).** :warning:
This repository will remain available as an example, and for users that have not yet had a chance to upgrade. However, there will be no further activity on issues or pull requests. The [@EdgeDevTools](https://twitter.com/EdgeDevTools) team will continue to work with the Selenium project to contribute future Microsoft Edge Driver features and bug fixes directly to Selenium 4.
* * *
[![Build Status](https://dev.azure.com/ms/edge-selenium-tools/_apis/build/status/microsoft.edge-selenium-tools?branchName=master)](https://dev.azure.com/ms/edge-selenium-tools/_build/latest?definitionId=345&branchName=master)
Selenium Tools for Microsoft Edge extends [Selenium 3](https://www.selenium.dev/) with a unified driver to help you write automated tests for both the Microsoft Edge (EdgeHTML) and new Microsoft Edge (Chromium) browsers.
Selenium Tools for Microsoft Edge extends [Selenium 3](https://github.com/SeleniumHQ/selenium/releases/tag/selenium-3.141.59) with a unified driver to help you write automated tests for both the Microsoft Edge (EdgeHTML) and new Microsoft Edge (Chromium) browsers.
The libraries included in this project are fully compatible with Selenium's built-in Edge libraries, and run Microsoft Edge (EdgeHTML) by default so you can use our project as a seamless drop-in replacement. In addition to being compatible with your existing Selenium tests, Selenium Tools for Microsoft Edge gives you the ability to drive the new Microsoft Edge (Chromium) browser and unlock all of the latest functionality!
@ -10,9 +17,9 @@ The classes in this package are based on the existing ``Edge`` and ``Chrome`` dr
## Before you Begin
The Selenium Tools for Microsoft Edge is a solution for developers who prefer to remain on Selenium 3 which is the current stable release and developers who have existing browser tests and want to add coverage for the new Microsoft Edge (Chromium) browser without changing the Selenium version.
Selenium Tools for Microsoft Edge was created as a compatiblity solution for developers who have existing Selenium 3 browser tests and want to add coverage for the latest Microsoft Edge (Chromium) browser. The [Microsoft Edge Developer Tools Team](https://twitter.com/EdgeDevTools) recommends using Selenium 4 instead because Selenium 4 has built-in support for Microsoft Edge (Chromium). If you are able to upgrade your existing tests, or write new tests using Selenium 4, then there is no need to use this package as Selenium should already have everything you need built in!
The very same ``Edge`` driver classes provided in this package are included in Selenium 4 and are already available today in the latest Selenium 4 Alpha release. If you are able to upgrade to Selenium 4 Alpha, there is no need to use this package as Selenium should already have everything you need built in!
See Selenium's upgrade [guide](https://www.selenium.dev/documentation/webdriver/getting_started/upgrade_to_selenium_4/) for help with upgrading from Selenium 3 to Selenium 4. If you are unable to upgrade due to a compatibility issues, please consider opening an issue in the official Selenium GitHub repo [here](https://github.com/SeleniumHQ/selenium/issues). If you have determined that you cannot upgrade from Selenium 3 at this time, and would still like to add test coverage for Microsoft Edge (Chromium) to your project, see the steps in the section below.
## Getting Started

Просмотреть файл

@ -54,6 +54,10 @@ class WebDriver(RemoteWebDriver):
"""
warnings.warn(
"Selenium Tools for Microsoft Edge is deprecated. Please upgrade to Selenium 4 which has built-in support for Microsoft Edge (Chromium): https://docs.microsoft.com/en-us/microsoft-edge/webdriver-chromium/#upgrading-from-selenium-3",
DeprecationWarning, stacklevel=2)
use_chromium = False
if (options and options.use_chromium) or \
(desired_capabilities and 'ms:edgeChromium' in desired_capabilities \

Просмотреть файл

@ -20,7 +20,7 @@ with open(join(abspath(dirname(__file__)), 'README.md'), 'r') as fh:
setup(
name = 'msedge-selenium-tools',
version = '3.141.3',
version = '3.141.4',
description = 'An updated EdgeDriver implementation for Selenium 3 with newly-added support for Microsoft Edge (Chromium).',
long_description = long_description,
long_description_content_type = 'text/markdown',