polyfill-library 3.106.0 → 3.110.0

package/.github/contributing.md

@@ -1,171 +0,0 @@
-# Contributing to polyfill-library
-
-♥ the polyfill-library and want to get involved?
-Thanks! There are plenty of ways you can help!
-
-Please take a moment to review this document in order to make the contribution
-process easy and effective for everyone involved.
-
-Following these guidelines helps to communicate that you respect the time of
-the developers managing and developing this open source project. In return,
-they should reciprocate that respect in addressing your issue or assessing
-patches and features.
-
-## Adding a new polyfill
-
-To generate the correct folder structure and files you can run `npm run create-new-polyfill <feature>`, where `<feature>` is the name of the feature. E.G. To create a new polyfill for `Element.prototype.nextElementSibling` it would be `npm run create-new-polyfill Element.prototype.nextElementSibling`.
-
-This documentation will use the [`Element.prototype.nextElementSibling` polyfill as an example](https://github.com/Financial-Times/polyfill-library/tree/master/polyfills/Element/prototype/nextElementSibling).
-
-If you run into any issues please ask us a question, we are happy to help.
-
-### Folder structure
-
-The name of your folder is based on the method structure, for example:
-
-`Element.prototype.nextElementSibling` would be `polyfills/Element/prototype/nextElementSibling`.
-
-This folder contains 4 files:
-
-- [config.toml](#configtoml)
-- [detect.js](#detectjs)
-- [polyfill.js](#polyfilljs)
-- [tests.js](#testsjs)
-
-### config.toml
-
-#### Aliases
-
-An alias is another name for the polyfill that can be used when requesting a bundle.
-
-For example, the alias `es5` is used to replicate an ECMAScript 5 environment.
-
-```toml
-aliases = [
-	'es5'
-]
-```
-
-#### Dependencies
-
-List any web platform features that you use in your polyfill.
-
-For example:
-
-```toml
-dependencies = [
-	"Element",
-	"Object.defineProperty"
-]
-```
-
-#### Browser compatibility
-List what browsers require the polyfill.
-
-You can check the related Mozilla Developer Network (MDN) page for the compatibility, they also have their browser compatibility data on GitHub.
-
-For example: [MDN nextElementSibling browser support](https://github.com/mdn/browser-compat-data/blob/master/api/NonDocumentTypeChildNode.json#L99-L149)
-
-Browsers that can be listed:
-- android
-- bb
-- chrome
-- edge
-- edge_mob
-- firefox
-- ios_chr
-- ios_saf
-- ie
-- ie_mob
-- opera
-- op_mini
-- safari
-- firefox_mob
-- samsung_mob
-
-The browser list uses a form of semantic versioning to indicate which browser requires polyfilling.
-
-If all versions of a browser require the polyfill you can use the wildcard asterisk (*):
-
-```toml
-[browsers]
-android = "*"
-```
-
-For specific versions you can specify a number, for example if a polyfill is required in Internet Explorer 8 and below you can use "<9":
-
-```toml
-[browsers]
-ie = "<9"
-```
-
-#### Additional information
-
-You can use the:
-
-- `spec` field for the feature's specification.
-- `docs` field for useful information.
-- `license` field for the license the code has been given.
-
-For example:
-```toml
-license = "MIT"
-spec = "https://dom.spec.whatwg.org/#dom-nondocumenttypechildnode-nextelementsibling"
-docs = "https://developer.mozilla.org/en-US/docs/Web/API/NonDocumentTypeChildNode/nextElementSibling"
-```
-
-### detect.js
-
-The detect.js file will be run to check if the feature is available to use in the browser.
-
-This is sometimes called [feature detection](https://developer.mozilla.org/en-US/docs/Learn/Tools_and_testing/Cross_browser_testing/Feature_detection) and it allows the browser to [detect and defer to native implementations](https://www.w3.org/2001/tag/doc/polyfills/#detect-and-defer-to-native-implementations).
-
-### polyfill.js
-
-This polyfill.js file will be run to enable a browser to work without the native implementation of the feature.
-
-If your polyfill requires other features to work [list them in the config file](#dependencies).
-
-Make sure your polyfill [does not squat on proposed names in speculative polyfills](https://www.w3.org/2001/tag/doc/polyfills/#don-t-squat-on-proposed-names-in-speculative-polyfills).
-
-### tests.js
-
-You should refer to the feature's specification to see how the feature should work.
-
-If there are [web platform tests, you should use them to help you](https://www.w3.org/2001/tag/doc/polyfills/#pass-web-platform-tests-if-they-exist).
-
-### Local development
-
-Setup you local environment :
-
-`$ npm install`
-
-Start the watcher :
-
-`$ npm run watch`
-
-After a file change you will see :
-
-```
-...
-Building : <Your Polyfill>
-Waiting for files to be written to disk...
-Built : <Your Polyfill> in 3s
-Visit : http://bs-local.com:9876/test?includePolyfills=yes&always=no&feature=<Your Polyfill>
-Test server listening on port 9876!
-```
-
-## Submitting a Pull Request
-
-Good pull requests, such as patches, improvements, and new features, are a fantastic help. They should remain focused in scope and avoid containing unrelated commits.
-
-Please **ask first** if somebody else is already working on this or the core developers think your feature is in-scope. Generally always have a related issue with discussions for whatever you are including.
-
-Please also provide a **test plan**, i.e. specify how you verified that your addition works.
-
-**IMPORTANT**: By submitting a patch, you agree to allow the project
-owners to license your work under the terms of the [MIT License](../LICENSE.md) and the [CLA](./contribution_licence_agreement.md).
-
----
-
-_Many thanks to [create-react-app](https://github.com/facebook/create-react-app/blob/master/CONTRIBUTING.md) for the inspiration with this contributing guide_

package/.github/contribution_licence_agreement.md

@@ -1,7 +0,0 @@
-All contributions to the polyfill service are made under the MIT licence. It is important therefore that you agree to the following when contributing code to the service:
-
-* Any contribution I make to the polyfill service by way of Pull Request contains only data that is:
-	* wholly my own work, upon which I am legally permitted to grant a licence; or
-	* wholly the work of individuals within the same organisation to which the copyright in all work created by employees is assigned, of which I am a current employee and authorised representive for the purposes of this contribution, and which is legally permitted to grant a licence; or
-	* licensed by the original author under the MIT licence or equivalent terms
-* In respect of any part of my contribution that is not already available under an MIT or compatible licence, I hereby grant to the Financial Times Limited (FT) and to recipients of software distributed by the FT a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable license to make, have made, use, offer to sell, sell, import, and otherwise transfer the data.

package/.github/issue_template.md

@@ -1,37 +0,0 @@
----
-title: Issue: [type] [short description]
----
-<!-- [type]: What is this issue for? A bug report? A feature request? -->
-
-<!--
-Please make sure you've checked that your issue hasn't already been raised within this repository.
-
-If you need help with submitting an issue, please get in touch with the Origami Team at origami.support@ft.com or #origami-support on Slack.
--->
-## What
-<!-- A clear description of what the problem or feature request is -->
-
-## Details
-<!--
-If it is a bug:
-- describe what the expected behaviour is, and what is actually happening
-- add steps on how to reproduce it
-- describe the environment you are having this problem in
-	- Browser + version (e.g. Chrome 70)
-	- Device (e.g. iPhone X, Desktop)
-	- provide screenshots to illustrate your problem
-
-If it is a feature request:
-	- explain what prompted this request — e.g. is it something that you regularly make a workaround for?
-	- describe what the new feature would do and how it would be used
-	- explain what alternatives you have explored / considered
-	- where possible, attach designs for the style of the new feature
--->
-
-<!--
-## Additional information
-For either type of issue:
-	- please add any other comments or details you might have
-	- if you've had a conversation about this with someone, please reference that person in this issue
-	- if there is a similar or related issue, please link to it
--->

package/.github/workflows/add-new-issues-and-pull-requests-to-origami-project-board.yml

@@ -1,15 +0,0 @@
-name: Add new issues and pull requests to Origami Project Board
-on:
-  - issues
-  - pull_request_target
-
-jobs:
-  origami_project_board_job:
-    runs-on: ubuntu-latest
-    name: Add new issue or pull request to Origami Project Board
-    steps:
-      - name: Add new issue or pull request to Origami Project Board
-        id: origami-project-board
-        uses: Financial-Times/origami-project-board-action@v1
-        with:
-          origami-fox-access-token: ${{ secrets.ORIGAMI_FOX_ACCESS_TOKEN }}

package/.github/workflows/apply-labels.yml

@@ -1,13 +0,0 @@
-name: Apply Origami labels
-on:
-  - issues
-  - pull_request_target
-jobs:
-  apply-labels:
-    runs-on: ubuntu-latest
-    name: Apply Origami labels to new issues and pull requests.
-    steps:
-      - uses: actions/checkout@v2
-      - uses: Financial-Times/origami-apply-labels@v1
-        with:
-          github-token: ${{ secrets.GITHUB_TOKEN }}

package/.github/workflows/auto-approve.yml

@@ -1,23 +0,0 @@
-name: Auto Approve Dependabot PRs
-
-on:
-  pull_request_target:
-    types: [labeled]
-
-jobs:
-  auto-update-dependabot:
-    name: Auto-Approve and enable Auto-Merge for all Dependabot PRs
-    runs-on: ubuntu-latest
-    if: github.event.pull_request.user.login == 'dependabot[bot]' && contains(github.event.pull_request.labels.*.name, 'dependencies')
-    steps:
-
-    # Enable auto-merge *before* issuing an approval.
-    - name: Enable Github Automerge
-      uses: alexwilson/enable-github-automerge-action@main
-      with:
-        github-token: "${{ secrets.ORIGAMI_FOX_ACCESS_TOKEN }}"
-
-    # We "trust" dependabot updates (this still requires all other checks to pass!)
-    - uses: hmarr/auto-approve-action@5d04a5ca6da9aeb8ca9f31a5239b96fc3e003029
-      with:
-        github-token: "${{ secrets.ORIGAMI_FOX_ACCESS_TOKEN }}"

package/.github/workflows/automatic-tag-and-release.yml

@@ -1,24 +0,0 @@
-on:
-  pull_request:
-    types:
-      [ closed ]
-      # Merged pull-requests count as closed pull-requests.
-
-jobs:
-  create-new-version:
-    runs-on: ubuntu-latest
-    name: Create new version/tag
-    steps:
-      - uses: actions/checkout@v2
-        if: github.event.pull_request.merged # Only run on merged pull-requests
-        with:
-          ref: ${{ github.event.pull_request.merge_commit_sha }} # Checkout the merged commit
-          fetch-depth: 0
-          token: ${{ secrets.ORIGAMI_VERSION_TOKEN }}
-      - run: git fetch --depth=1 origin +refs/tags/*:refs/tags/* # Get all tags from the origin
-        if: github.event.pull_request.merged # Only run on merged pull-requests
-      - uses: Financial-Times/origami-version@v1.2.1
-        name: Create new version/tag
-        if: github.event.pull_request.merged # Only run on merged pull-requests
-        with:
-          github-token: ${{ secrets.ORIGAMI_GITHUB_TOKEN }}

package/.github/workflows/lint.yml

@@ -1,19 +0,0 @@
-name: Lint
-on:
-  push:
-    branches:
-      - '*'
-      - '**'
-      - '!master'
-jobs:
-  lint:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2.2.0
-        with:
-          node-version: 12.x
-          cache: 'npm'
-      - run: npm ci
-      - run: npm run build
-      - run: npm run lint

package/.github/workflows/lock.yml

@@ -1,14 +0,0 @@
-name: 'Lock threads'
-
-on:
-  schedule:
-    - cron: '0 0 * * *'
-
-jobs:
-  lock:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: dessant/lock-threads@486f7380c15596f92b724e4260e4981c68d6bde6 # pin@v2
-        with:
-          github-token: ${{ github.token }}
-          issue-lock-inactive-days: '180'

package/.github/workflows/publish-to-npm-as-latest.yml

@@ -1,23 +0,0 @@
-name: Publish to npm as latest version
-on:
-  push:
-    tags:
-      - 'v[0-9]+.[0-9]+.[0-9]+' # non-prerelease tag
-jobs:
-  publish-latest:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2.2.0
-        with:
-          node-version: '12.x'
-          registry-url: 'https://registry.npmjs.org'
-          cache: 'npm'
-      - run: npm ci
-      - name: Get the version
-        id: version
-        run: echo ::set-output name=VERSION::${GITHUB_REF/refs\/tags\//}
-      - run: npm version --no-git-tag-version ${{ steps.version.outputs.VERSION }}
-      - run: npm publish
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.github/workflows/publish-to-npm-as-prerelease.yml

@@ -1,23 +0,0 @@
-name: Publish to npm as prerelease version
-on:
-  push:
-    tags:
-      - 'v[0-9]+.[0-9]+.[0-9]+-*' # prerelease tag
-jobs:
-  publish-prerelease:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2.2.0
-        with:
-          node-version: '12.x'
-          registry-url: 'https://registry.npmjs.org'
-          cache: 'npm'
-      - run: npm ci
-      - name: Get the version
-        id: version
-        run: echo ::set-output name=VERSION::${GITHUB_REF/refs\/tags\//}
-      - run: npm version --no-git-tag-version ${{ steps.version.outputs.VERSION }}
-      - run: npm publish --tag prerelease
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.github/workflows/push-forked-branch-to-origin.yml

@@ -1,17 +0,0 @@
-name: Push forked branch to origin to run tests
-on:
-  workflow_dispatch:
-    inputs:
-      number:
-        description: 'pull-request number'
-        required: true
-jobs:
-  push-forked-branch-to-origin:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v2
-      #     - run: gh pr checkout ${{ github.event.inputs.number }} && git push origin -f
-      - run: hub pr checkout ${{ github.event.inputs.number }} && git push origin
-          HEAD:pr${{ github.event.inputs.number }} -f
-        env:
-          GITHUB_TOKEN: "${{ secrets.POLYFILL_GH_TOKEN }}"

package/.github/workflows/sync-repo-labels.yml

@@ -1,12 +0,0 @@
-name: Sync Origami labels
-on:
-  - issues
-  - pull_request_target
-jobs:
-  sync-labels:
-    runs-on: ubuntu-latest
-    name: Sync repository labels
-    steps:
-      - uses: Financial-Times/origami-labels@v1
-        with:
-          github-token: ${{ secrets.GITHUB_TOKEN }}

package/.github/workflows/test-polyfills-weekly.yml

@@ -1,72 +0,0 @@
-name: Test Polyfills Weekly
-on:
-  schedule:
-    - cron: '0 23 * * 0' # TODO : set convenient weekly retest time
-  workflow_dispatch:
-
-jobs:
-  check-for-other-pull-requests-running-this-workflow:
-    runs-on: ubuntu-latest
-    if: ${{ github.pull_request.head.repo.fork == false}}
-    steps:
-      - name: Cancel Previous Runs
-        uses: styfle/cancel-workflow-action@89f242ee29e10c53a841bfe71cc0ce7b2f065abc # pin@0.8.0
-        with:
-          access_token: ${{ github.token }}
-      - name: Turnstyle
-        uses: softprops/turnstyle@a714535c65d622af7010e609960ccf0ea5001e3f # pin@v1
-        with:
-          same-branch-only: false
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-  test:
-    runs-on: ubuntu-latest
-    needs: [ check-for-other-pull-requests-running-this-workflow ]
-    strategy:
-      max-parallel: 1
-      fail-fast: false
-      matrix:
-        browser: [ ie, android, chrome, edge, firefox, ios, safari ]
-
-    steps:
-      - uses: actions/checkout@v2
-        with:
-          fetch-depth: 1
-
-
-      - uses: actions/setup-node@v2.2.0
-        with:
-          node-version: 12.x
-          cache: 'npm'
-
-      - name: env
-        run: echo "commit-sha=$(echo ${GITHUB_SHA})" >> $GITHUB_ENV
-
-      - run: npm ci
-
-      - name: cache __dist
-        id: cache-dist
-        uses: actions/cache@v2.1.5
-        with:
-          path: polyfills/__dist
-          key: cache--dist--${{ env.commit-sha }}
-
-      - run: npm run build
-        if: steps.cache-dist.outputs.cache-hit != 'true'
-
-      - run: echo "${{ matrix.browser }}" > $GITHUB_WORKSPACE/witness-${{ matrix.browser }}
-      - name: record ${{ matrix.browser }} witness
-        id: witness
-        uses: actions/cache@v2.1.5
-        with:
-          path: $GITHUB_WORKSPACE/witness-${{ matrix.browser }}
-          key: witness--weekly-tests--${{ matrix.browser }}--${{ env.commit-sha }}
-
-      - name: Test ${{ matrix.browser }}
-        run: node ./test/polyfills/server.js & node ./test/polyfills/remotetest.js
-          test-polyfill-combinations targeted director browser=${{ matrix.browser }}
-        if: steps.witness.outputs.cache-hit != 'true'
-        timeout-minutes: 30
-        env:
-          BROWSERSTACK_USERNAME: ${{ secrets.BROWSERSTACK_USERNAME }}
-          BROWSERSTACK_ACCESS_KEY: ${{ secrets.BROWSERSTACK_ACCESS_KEY }}

package/.github/workflows/test-polyfills.yml

@@ -1,76 +0,0 @@
-name: Test Polyfills
-on:
-  push:
-    branches:
-      - '*'
-      - '**'
-      - '!master'
-
-jobs:
-  check-for-other-pull-requests-running-this-workflow:
-    runs-on: ubuntu-latest
-    if: ${{ github.pull_request.head.repo.fork == false}}
-    steps:
-      - name: Cancel Previous Runs
-        uses: styfle/cancel-workflow-action@89f242ee29e10c53a841bfe71cc0ce7b2f065abc # pin@0.8.0
-        with:
-          access_token: ${{ github.token }}
-      - name: Turnstyle
-        uses: softprops/turnstyle@a714535c65d622af7010e609960ccf0ea5001e3f # pin@v1
-        with:
-          same-branch-only: false
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-  test:
-    runs-on: ubuntu-latest
-    needs: [ check-for-other-pull-requests-running-this-workflow ]
-    strategy:
-      max-parallel: 1
-      fail-fast: false
-      matrix:
-        browser: [ ie, android, chrome, edge, firefox, ios, safari ]
-
-    steps:
-      - uses: actions/checkout@v2
-        with:
-          fetch-depth: 0
-
-      - run: git remote add upstream https://github.com/Financial-Times/polyfill-library.git
-      - run: git fetch upstream master
-
-      - uses: actions/setup-node@v2.2.0
-        with:
-          node-version: 12.x
-          cache: 'npm'
-
-      - name: env
-        run: echo "commit-sha=$(echo ${GITHUB_SHA})" >> $GITHUB_ENV
-
-      - run: npm ci
-
-      - name: cache __dist
-        id: cache-dist
-        uses: actions/cache@v2.1.5
-        with:
-          path: polyfills/__dist
-          key: cache--dist--${{ env.commit-sha }}
-
-      - run: npm run build
-        if: steps.cache-dist.outputs.cache-hit != 'true'
-
-      - run: echo "${{ matrix.browser }}" > $GITHUB_WORKSPACE/witness-${{ matrix.browser }}
-      - name: record ${{ matrix.browser }} witness
-        id: witness
-        uses: actions/cache@v2.1.5
-        with:
-          path: $GITHUB_WORKSPACE/witness-${{ matrix.browser }}
-          key: witness--${{ matrix.browser }}--${{ env.commit-sha }}
-
-      - name: Test ${{ matrix.browser }}
-        run: node ./test/polyfills/server.js & node ./test/polyfills/remotetest.js
-          test-modified-only targeted director browser=${{ matrix.browser }}
-        if: steps.witness.outputs.cache-hit != 'true'
-        timeout-minutes: 30
-        env:
-          BROWSERSTACK_USERNAME: ${{ secrets.BROWSERSTACK_USERNAME }}
-          BROWSERSTACK_ACCESS_KEY: ${{ secrets.BROWSERSTACK_ACCESS_KEY }}

package/.github/workflows/unit-test.yml

@@ -1,19 +0,0 @@
-name: Unit Test
-on:
-  push:
-    branches:
-      - '*'
-      - '**'
-      - '!master'
-jobs:
-  unit-test:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2.2.0
-        with:
-          node-version: 12.x
-          cache: 'npm'
-      - run: npm ci
-      - run: npm run build
-      - run: npm run test-library