From 509c84daf1cdedb3a5d6693026c6bd7dc1c6c552 Mon Sep 17 00:00:00 2001 From: Timo Tijhof Date: Sat, 20 Apr 2024 17:43:28 +0100 Subject: [PATCH 01/40] Build: Fix spider-check.yaml syntax, and fix actions/checkout deprecation warning Follows-up 52f94a133b. --- .github/workflows/spider-check.yaml | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/.github/workflows/spider-check.yaml b/.github/workflows/spider-check.yaml index 8640892f..0c75b5f1 100644 --- a/.github/workflows/spider-check.yaml +++ b/.github/workflows/spider-check.yaml @@ -16,15 +16,12 @@ on: jobs: spider-check: if: ${{ github.repository_owner == 'jquery' }} # skip on forks - env: - MY_SITE: https://api.jquery.com runs-on: ubuntu-latest env: # Site address to crawl MY_SITE: https://api.jquery.com steps: - - name: Checkout repo - uses: actions/checkout@v3 + - uses: actions/checkout@v4 - name: Run hydra-link-checker run: | From ff7c6dde268546c13412f88a8b4291fbaa63c055 Mon Sep 17 00:00:00 2001 From: Timo Tijhof Date: Sat, 20 Apr 2024 19:03:08 +0100 Subject: [PATCH 02/40] 3.3.3 --- package-lock.json | 4 ++-- package.json | 22 ++-------------------- 2 files changed, 4 insertions(+), 22 deletions(-) diff --git a/package-lock.json b/package-lock.json index 721ee9e8..5d6a7229 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "api.jquery.com", - "version": "3.3.2", + "version": "3.3.3", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "api.jquery.com", - "version": "3.3.2", + "version": "3.3.3", "dependencies": { "grunt": "1.6.1", "grunt-jquery-content": "3.3.1" diff --git a/package.json b/package.json index 5ce26e0d..033a4869 100644 --- a/package.json +++ b/package.json @@ -1,25 +1,7 @@ { "name": "api.jquery.com", - "title": "jQuery API Docs", - "description": "API reference documentation for the jQuery JavaScript Library.", - "version": "3.3.2", - "homepage": "https://github.com/jquery/api.jquery.com", - "author": { - "name": "jQuery Foundation and other contributors" - }, - "repository": { - "type": "git", - "url": "git://github.com/jquery/api.jquery.com.git" - }, - "bugs": { - "url": "https://github.com/jquery/api.jquery.com/issues" - }, - "licenses": [ - { - "type": "MIT", - "url": "https://github.com/jquery/api.jquery.com/blob/main/LICENSE.txt" - } - ], + "version": "3.3.3", + "private": true, "scripts": { "test": "grunt lint" }, From d87bf6448028e51deeb6c15393d2a5613d9b3c49 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 17 Jun 2024 10:26:49 -0400 Subject: [PATCH 03/40] Build: Bump braces from 3.0.2 to 3.0.3 (#1245) Bumps [braces](https://github.com/micromatch/braces) from 3.0.2 to 3.0.3. - [Changelog](https://github.com/micromatch/braces/blob/master/CHANGELOG.md) - [Commits](https://github.com/micromatch/braces/compare/3.0.2...3.0.3) --- updated-dependencies: - dependency-name: braces dependency-type: indirect ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- package-lock.json | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/package-lock.json b/package-lock.json index 5d6a7229..cf341bc7 100644 --- a/package-lock.json +++ b/package-lock.json @@ -85,11 +85,11 @@ } }, "node_modules/braces": { - "version": "3.0.2", - "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.2.tgz", - "integrity": "sha512-b8um+L1RzM3WDSzvhm6gIz1yfTbBt6YTlcEKAvsmqCZZFw46z626lVj9j1yEPW33H5H+lBQpZMP1k8l+78Ha0A==", + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz", + "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==", "dependencies": { - "fill-range": "^7.0.1" + "fill-range": "^7.1.1" }, "engines": { "node": ">=8" @@ -321,9 +321,9 @@ "integrity": "sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==" }, "node_modules/fill-range": { - "version": "7.0.1", - "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.0.1.tgz", - "integrity": "sha512-qOo9F+dMUmC2Lcb4BbVvnKJxTPjCm+RRpe4gDuGrzkL7mEVl/djYSu2OdQ2Pa302N4oqkSg9ir6jaLWJ2USVpQ==", + "version": "7.1.1", + "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz", + "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==", "dependencies": { "to-regex-range": "^5.0.1" }, From 3f01a7368264a4c890121a5282f723567a5d6568 Mon Sep 17 00:00:00 2001 From: Timmy Willison Date: Fri, 5 Jul 2024 14:14:35 -0400 Subject: [PATCH 04/40] All: upgrade jQuery to 3.7.1 in demos Closes gh-1247 --- entries2html.xsl | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/entries2html.xsl b/entries2html.xsl index 37bfdb3c..a1a19982 100755 --- a/entries2html.xsl +++ b/entries2html.xsl @@ -12,7 +12,7 @@ <meta charset="utf-8"> <title> demo</title> <style> </style> - <script src="https://code.jquery.com/jquery-3.7.0.js"></script> + <script src="https://code.jquery.com/jquery-3.7.1.js"></script> <script> </script> From 86e09e03184ba33609f7b94003ee5b7db04c106e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?= Date: Fri, 12 Jul 2024 23:59:00 +0200 Subject: [PATCH 05/40] Build: Update .nvmrc from 10 to 18 --- .nvmrc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.nvmrc b/.nvmrc index f599e28b..3c032078 100644 --- a/.nvmrc +++ b/.nvmrc @@ -1 +1 @@ -10 +18 From 96a447a550463f2b101ffd1fbbd4d7e98f3cc25b Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Fri, 30 Aug 2024 17:36:41 +0200 Subject: [PATCH 06/40] Build: Bump micromatch from 4.0.4 to 4.0.8 Bumps [micromatch](https://github.com/micromatch/micromatch) from 4.0.4 to 4.0.8. - [Release notes](https://github.com/micromatch/micromatch/releases) - [Changelog](https://github.com/micromatch/micromatch/blob/master/CHANGELOG.md) - [Commits](https://github.com/micromatch/micromatch/compare/4.0.4...4.0.8) Closes gh-1250 --- updated-dependencies: - dependency-name: micromatch dependency-type: indirect ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- package-lock.json | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/package-lock.json b/package-lock.json index cf341bc7..d40358ff 100644 --- a/package-lock.json +++ b/package-lock.json @@ -934,12 +934,12 @@ } }, "node_modules/micromatch": { - "version": "4.0.4", - "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.4.tgz", - "integrity": "sha512-pRmzw/XUcwXGpD9aI9q/0XOwLNygjETJ8y0ao0wdqprrzDa4YnxLcz7fQRZr8voh8V10kGhABbNcHVk5wHgWwg==", + "version": "4.0.8", + "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz", + "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==", "dependencies": { - "braces": "^3.0.1", - "picomatch": "^2.2.3" + "braces": "^3.0.3", + "picomatch": "^2.3.1" }, "engines": { "node": ">=8.6" @@ -1125,9 +1125,9 @@ } }, "node_modules/picomatch": { - "version": "2.2.3", - "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.2.3.tgz", - "integrity": "sha512-KpELjfwcCDUb9PeigTs2mBJzXUPzAuP2oPcA989He8Rte0+YUAjw1JVedDhuTKPkHjSYzMN3npC9luThGYEKdg==", + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz", + "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==", "engines": { "node": ">=8.6" }, From fa2d5a2eb88f4caed98eb4c711e71b6712ea2415 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?= Date: Sun, 15 Sep 2024 00:26:41 +0200 Subject: [PATCH 07/40] 3.3.4 --- package-lock.json | 4 ++-- package.json | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/package-lock.json b/package-lock.json index d40358ff..4d7dc4c8 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "api.jquery.com", - "version": "3.3.3", + "version": "3.3.4", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "api.jquery.com", - "version": "3.3.3", + "version": "3.3.4", "dependencies": { "grunt": "1.6.1", "grunt-jquery-content": "3.3.1" diff --git a/package.json b/package.json index 033a4869..5ab2be8d 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "api.jquery.com", - "version": "3.3.3", + "version": "3.3.4", "private": true, "scripts": { "test": "grunt lint" From 4d51b6f3d62ae75f9afd732a3d6c5e148d1d7fea Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?= Date: Mon, 30 Sep 2024 18:16:54 +0200 Subject: [PATCH 08/40] Build: Refer to commits of GitHub Actions, upgrade them Also, set up automatic Dependabot updates of actions grouped into a single PR as Core does. Ref jquery/jquery#5503 Closes gh-1248 --- .github/dependabot.yml | 13 +++++++++++++ .github/workflows/node.js.yml | 26 ++++++++++++++------------ .github/workflows/spider-check.yaml | 3 ++- .github/workflows/typesense.yaml | 3 ++- 4 files changed, 31 insertions(+), 14 deletions(-) create mode 100644 .github/dependabot.yml diff --git a/.github/dependabot.yml b/.github/dependabot.yml new file mode 100644 index 00000000..aa2f7456 --- /dev/null +++ b/.github/dependabot.yml @@ -0,0 +1,13 @@ +version: 2 +updates: + - package-ecosystem: github-actions + directory: "/" + schedule: + interval: monthly + + # Group all dependabot version update PRs into one + groups: + github-actions: + applies-to: version-updates + patterns: + - "*" diff --git a/.github/workflows/node.js.yml b/.github/workflows/node.js.yml index d74cb10f..f70d7edf 100644 --- a/.github/workflows/node.js.yml +++ b/.github/workflows/node.js.yml @@ -3,8 +3,9 @@ name: Node.js CI on: - - push - - pull_request + pull_request: + push: + branches-ignore: "dependabot/**" jobs: build: @@ -16,13 +17,14 @@ jobs: node-version: [18.x, 20.x] steps: - - name: Install xmllint - run: sudo apt-get install -y libxml2-utils - - uses: actions/checkout@v3 - - name: Use Node.js ${{ matrix.node-version }} - uses: actions/setup-node@v3 - with: - node-version: ${{ matrix.node-version }} - cache: 'npm' - - run: npm ci - - run: npm test + - name: Checkout + uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332 # v4.1.7 + - name: Install xmllint + run: sudo apt-get install -y libxml2-utils + - name: Use Node.js ${{ matrix.node-version }} + uses: actions/setup-node@1e60f620b9541d16bece96c5465dc8ee9832be0b # v4.0.3 + with: + node-version: ${{ matrix.node-version }} + cache: 'npm' + - run: npm ci + - run: npm test diff --git a/.github/workflows/spider-check.yaml b/.github/workflows/spider-check.yaml index 0c75b5f1..d4802190 100644 --- a/.github/workflows/spider-check.yaml +++ b/.github/workflows/spider-check.yaml @@ -21,7 +21,8 @@ jobs: # Site address to crawl MY_SITE: https://api.jquery.com steps: - - uses: actions/checkout@v4 + - name: Checkout + uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332 # v4.1.7 - name: Run hydra-link-checker run: | diff --git a/.github/workflows/typesense.yaml b/.github/workflows/typesense.yaml index da194255..58bf1b65 100644 --- a/.github/workflows/typesense.yaml +++ b/.github/workflows/typesense.yaml @@ -16,7 +16,8 @@ jobs: if: ${{ github.repository_owner == 'jquery' }} # skip on forks runs-on: ubuntu-latest steps: - - uses: actions/checkout@v3 + - name: Checkout + uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332 # v4.1.7 - name: Docsearch Scraper shell: bash run: | From b026c03e3d66d7649a59c653c491b39444fff48d Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 30 Sep 2024 18:43:42 +0200 Subject: [PATCH 09/40] Build: Bump the github-actions group with 2 updates Bumps the github-actions group with 2 updates: [actions/checkout](https://github.com/actions/checkout) and [actions/setup-node](https://github.com/actions/setup-node). Updates `actions/checkout` from 4.1.7 to 4.2.0 - [Release notes](https://github.com/actions/checkout/releases) - [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md) - [Commits](https://github.com/actions/checkout/compare/692973e3d937129bcbf40652eb9f2f61becf3332...d632683dd7b4114ad314bca15554477dd762a938) Updates `actions/setup-node` from 4.0.3 to 4.0.4 - [Release notes](https://github.com/actions/setup-node/releases) - [Commits](https://github.com/actions/setup-node/compare/1e60f620b9541d16bece96c5465dc8ee9832be0b...0a44ba7841725637a19e28fa30b79a866c81b0a6) Closes gh-1252 --- updated-dependencies: - dependency-name: actions/checkout dependency-type: direct:production update-type: version-update:semver-minor dependency-group: github-actions - dependency-name: actions/setup-node dependency-type: direct:production update-type: version-update:semver-patch dependency-group: github-actions ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- .github/workflows/node.js.yml | 4 ++-- .github/workflows/spider-check.yaml | 2 +- .github/workflows/typesense.yaml | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/.github/workflows/node.js.yml b/.github/workflows/node.js.yml index f70d7edf..82bcc0d3 100644 --- a/.github/workflows/node.js.yml +++ b/.github/workflows/node.js.yml @@ -18,11 +18,11 @@ jobs: steps: - name: Checkout - uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332 # v4.1.7 + uses: actions/checkout@d632683dd7b4114ad314bca15554477dd762a938 # v4.2.0 - name: Install xmllint run: sudo apt-get install -y libxml2-utils - name: Use Node.js ${{ matrix.node-version }} - uses: actions/setup-node@1e60f620b9541d16bece96c5465dc8ee9832be0b # v4.0.3 + uses: actions/setup-node@0a44ba7841725637a19e28fa30b79a866c81b0a6 # v4.0.4 with: node-version: ${{ matrix.node-version }} cache: 'npm' diff --git a/.github/workflows/spider-check.yaml b/.github/workflows/spider-check.yaml index d4802190..5d138842 100644 --- a/.github/workflows/spider-check.yaml +++ b/.github/workflows/spider-check.yaml @@ -22,7 +22,7 @@ jobs: MY_SITE: https://api.jquery.com steps: - name: Checkout - uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332 # v4.1.7 + uses: actions/checkout@d632683dd7b4114ad314bca15554477dd762a938 # v4.2.0 - name: Run hydra-link-checker run: | diff --git a/.github/workflows/typesense.yaml b/.github/workflows/typesense.yaml index 58bf1b65..f56e941d 100644 --- a/.github/workflows/typesense.yaml +++ b/.github/workflows/typesense.yaml @@ -17,7 +17,7 @@ jobs: runs-on: ubuntu-latest steps: - name: Checkout - uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332 # v4.1.7 + uses: actions/checkout@d632683dd7b4114ad314bca15554477dd762a938 # v4.2.0 - name: Docsearch Scraper shell: bash run: | From b7041b51db866afa4410ff24235e359b831b8578 Mon Sep 17 00:00:00 2001 From: Timmy Willison Date: Wed, 9 Oct 2024 06:58:13 -0700 Subject: [PATCH 10/40] Build: update default deployment config Closes gh-1253 --- config-sample.json | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/config-sample.json b/config-sample.json index a62b85f2..2a56329c 100644 --- a/config-sample.json +++ b/config-sample.json @@ -1,5 +1,5 @@ { - "url": "vagrant.api.jquery.com", - "username": "admin", - "password": "secret" + "url": "http://local.api.jquery.com", + "username": "dev", + "password": "dev" } From 85ed300d727f80cdef5b4f15365f6fe935784c46 Mon Sep 17 00:00:00 2001 From: Timmy Willison Date: Sun, 13 Oct 2024 15:43:18 -0400 Subject: [PATCH 11/40] Categories: add version support warnings to old versions Ref https://github.com/jquery/jquery-wp-content/pull/468 Ref https://github.com/jquery/jquery.com/pull/246 Closes gh-1251 --- categories.xml | 200 ++++++++++++++++++++++++++++++++++++------------- 1 file changed, 147 insertions(+), 53 deletions(-) diff --git a/categories.xml b/categories.xml index 2f408651..a8460562 100644 --- a/categories.xml +++ b/categories.xml @@ -37,57 +37,74 @@ - - - - - - - - - - - - @@ -326,193 +343,270 @@ var files = event.originalEvent.dataTransfer.files; - - - - - - - - - - - - - - - + - + - + Date: Mon, 14 Oct 2024 18:23:17 +0200 Subject: [PATCH 13/40] All: Add a 4.0 version category Closes gh-1255 --- categories.xml | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/categories.xml b/categories.xml index a8460562..8dc523ec 100644 --- a/categories.xml +++ b/categories.xml @@ -613,6 +613,17 @@ var files = event.originalEvent.dataTransfer.files;
]]>
+ + + From a9c3f495665d7d46393a6910c9631f33fb8956a9 Mon Sep 17 00:00:00 2001 From: Flinti Date: Mon, 21 Oct 2024 00:19:21 +0200 Subject: [PATCH 14/40] jQuery: Add a self-closed tag back to an example This adds an actual quick-closed tag in this code example, as it is implied by the text that there can be one: > Tags that cannot contain elements may be quick-closed or not: > ```js > $( "" ); > $( "" ); > ``` to: > Tags that cannot contain elements may be quick-closed or not: > ```js > $( "" ); > $( "" ); > ``` Closes gh-1264 --- entries/jQuery.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/entries/jQuery.xml b/entries/jQuery.xml index 921ca1a9..398f10b4 100644 --- a/entries/jQuery.xml +++ b/entries/jQuery.xml @@ -183,7 +183,7 @@ $( myForm.elements ).hide();
$( "<a href='https://jquery.com'></a>" );

Tags that cannot contain elements may be quick-closed or not:


-$( "<img>" );
+$( "<img />" );
 $( "<input>" );
       

When passing HTML to jQuery(), note that text nodes are not treated as DOM elements. With the exception of a few methods (such as .content()), they are generally ignored or removed. E.g:

From 66762a6022f08ea751723a0130265df70c331289 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?= Date: Mon, 21 Oct 2024 00:19:38 +0200 Subject: [PATCH 15/40] 3.3.6 --- package-lock.json | 4 ++-- package.json | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/package-lock.json b/package-lock.json index bdde5766..1abf8278 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "api.jquery.com", - "version": "3.3.5", + "version": "3.3.6", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "api.jquery.com", - "version": "3.3.5", + "version": "3.3.6", "dependencies": { "grunt": "1.6.1", "grunt-jquery-content": "3.3.1" diff --git a/package.json b/package.json index 8e88f25d..1e27f2f0 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "api.jquery.com", - "version": "3.3.5", + "version": "3.3.6", "private": true, "scripts": { "test": "grunt lint" From eacda2bd63ef5f9ef81010656603e9b15eb3ed64 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Fri, 1 Nov 2024 11:30:43 -0400 Subject: [PATCH 16/40] Build: Bump the github-actions group with 2 updates Bumps the github-actions group with 2 updates: [actions/checkout](https://github.com/actions/checkout) and [actions/setup-node](https://github.com/actions/setup-node). Updates `actions/checkout` from 4.2.0 to 4.2.2 - [Release notes](https://github.com/actions/checkout/releases) - [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md) - [Commits](https://github.com/actions/checkout/compare/d632683dd7b4114ad314bca15554477dd762a938...11bd71901bbe5b1630ceea73d27597364c9af683) Updates `actions/setup-node` from 4.0.4 to 4.1.0 - [Release notes](https://github.com/actions/setup-node/releases) - [Commits](https://github.com/actions/setup-node/compare/0a44ba7841725637a19e28fa30b79a866c81b0a6...39370e3970a6d050c480ffad4ff0ed4d3fdee5af) --- updated-dependencies: - dependency-name: actions/checkout dependency-type: direct:production update-type: version-update:semver-patch dependency-group: github-actions - dependency-name: actions/setup-node dependency-type: direct:production update-type: version-update:semver-minor dependency-group: github-actions ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Closes gh-1265 --- .github/workflows/node.js.yml | 4 ++-- .github/workflows/spider-check.yaml | 2 +- .github/workflows/typesense.yaml | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/.github/workflows/node.js.yml b/.github/workflows/node.js.yml index 82bcc0d3..31cdcfcd 100644 --- a/.github/workflows/node.js.yml +++ b/.github/workflows/node.js.yml @@ -18,11 +18,11 @@ jobs: steps: - name: Checkout - uses: actions/checkout@d632683dd7b4114ad314bca15554477dd762a938 # v4.2.0 + uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2 - name: Install xmllint run: sudo apt-get install -y libxml2-utils - name: Use Node.js ${{ matrix.node-version }} - uses: actions/setup-node@0a44ba7841725637a19e28fa30b79a866c81b0a6 # v4.0.4 + uses: actions/setup-node@39370e3970a6d050c480ffad4ff0ed4d3fdee5af # v4.1.0 with: node-version: ${{ matrix.node-version }} cache: 'npm' diff --git a/.github/workflows/spider-check.yaml b/.github/workflows/spider-check.yaml index 5d138842..378da3db 100644 --- a/.github/workflows/spider-check.yaml +++ b/.github/workflows/spider-check.yaml @@ -22,7 +22,7 @@ jobs: MY_SITE: https://api.jquery.com steps: - name: Checkout - uses: actions/checkout@d632683dd7b4114ad314bca15554477dd762a938 # v4.2.0 + uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2 - name: Run hydra-link-checker run: | diff --git a/.github/workflows/typesense.yaml b/.github/workflows/typesense.yaml index f56e941d..de973410 100644 --- a/.github/workflows/typesense.yaml +++ b/.github/workflows/typesense.yaml @@ -17,7 +17,7 @@ jobs: runs-on: ubuntu-latest steps: - name: Checkout - uses: actions/checkout@d632683dd7b4114ad314bca15554477dd762a938 # v4.2.0 + uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2 - name: Docsearch Scraper shell: bash run: | From b98f448f13151024452047e17ada37693f2bb034 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?= Date: Mon, 16 Dec 2024 18:54:28 +0100 Subject: [PATCH 17/40] Attr: Document jQuery 4 boolean attribute changes (#1263) Fixes gh-1243 Ref jquery/jquery#5452 Ref jquery/jquery-migrate#540 --- entries/attr.xml | 25 ++++++++++++++++++++----- 1 file changed, 20 insertions(+), 5 deletions(-) diff --git a/entries/attr.xml b/entries/attr.xml index 03baf91c..ac3e5a1b 100644 --- a/entries/attr.xml +++ b/entries/attr.xml @@ -26,7 +26,7 @@

Attributes vs. Properties

The difference between attributes and properties can be important in specific situations. Before jQuery 1.6, the .attr() method sometimes took property values into account when retrieving some attributes, which could cause inconsistent behavior. As of jQuery 1.6, the .prop() method provides a way to explicitly retrieve property values, while .attr() retrieves attributes.

For example, selectedIndex, tagName, nodeName, nodeType, ownerDocument, defaultChecked, and defaultSelected should be retrieved and set with the .prop() method. Prior to jQuery 1.6, these properties were retrievable with the .attr() method, but this was not within the scope of attr. These do not have corresponding attributes and are only properties.

-

Concerning boolean attributes, consider a DOM element defined by the HTML markup <input type="checkbox" checked="checked" />, and assume it is in a JavaScript variable named elem:

+

Concerning boolean attributes, consider a DOM element defined by the HTML markup <input type="checkbox" checked="" />, and assume it is in a JavaScript variable named elem:

- + + + + + @@ -131,6 +138,7 @@ The title of the emphasis is:
+ @@ -142,7 +150,8 @@ The title of the emphasis is:
- A value to set for the attribute. If null, the specified attribute will be removed (as in .removeAttr()). + + A value to set for the attribute. If null, the specified attribute will be removed (as in .removeAttr()). Non-ARIA attributes can also be removed by passing false.
@@ -162,7 +171,7 @@ The title of the emphasis is:
- +
@@ -188,6 +197,11 @@ $( "#greatphoto" ).attr({ });

When setting multiple attributes, the quotes around attribute names are optional.

+

Removing an attribute

+

To remove an attribute, either call .attr( name, null ) or use .removeAttr( name ). For non-ARIA attributes, in jQuery 4.0+ you can also call .attr( name, false ).

+
+

Note: Because ARIA attributes frequently associate behavior with "false" values that differs from attribute absence, passing false as the value for an attribute whose name starts with "aria-…" will stringify that value to "false" rather than remove the attribute. To guarantee removal of an attribute, use the .removeAttr() method or provide null as the value to the .attr() setter.

+

WARNING: When setting the 'class' attribute, you must always use quotes!

Note: Attempting to change the type attribute on an input or button element created via document.createElement() will throw an exception on Internet Explorer 8 or older.

@@ -273,5 +287,6 @@ $( "img" ).attr( "src", function() { + From 2a74c71f873c4ef16dd17f2d616b4da1ba36de77 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sun, 2 Feb 2025 13:40:20 +0100 Subject: [PATCH 18/40] Build: Bump actions/setup-node from 4.1.0 to 4.2.0 in the github-actions group Bumps the github-actions group with 1 update: [actions/setup-node](https://github.com/actions/setup-node). Closes gh-1267 Updates `actions/setup-node` from 4.1.0 to 4.2.0 - [Release notes](https://github.com/actions/setup-node/releases) - [Commits](https://github.com/actions/setup-node/compare/39370e3970a6d050c480ffad4ff0ed4d3fdee5af...1d0ff469b7ec7b3cb9d8673fde0c81c44821de2a) --- updated-dependencies: - dependency-name: actions/setup-node dependency-type: direct:production update-type: version-update:semver-minor dependency-group: github-actions ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- .github/workflows/node.js.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/node.js.yml b/.github/workflows/node.js.yml index 31cdcfcd..e9d2fe6c 100644 --- a/.github/workflows/node.js.yml +++ b/.github/workflows/node.js.yml @@ -22,7 +22,7 @@ jobs: - name: Install xmllint run: sudo apt-get install -y libxml2-utils - name: Use Node.js ${{ matrix.node-version }} - uses: actions/setup-node@39370e3970a6d050c480ffad4ff0ed4d3fdee5af # v4.1.0 + uses: actions/setup-node@1d0ff469b7ec7b3cb9d8673fde0c81c44821de2a # v4.2.0 with: node-version: ${{ matrix.node-version }} cache: 'npm' From 118b48046a219b370c284207704d88c0699c5145 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?= Date: Mon, 3 Mar 2025 18:16:33 +0100 Subject: [PATCH 19/40] All: Record APIs removed in 4.0 Fixes gh-1172 Fixes gh-1200 Closes gh-1262 --- entries/jQuery.fx.interval.xml | 2 +- entries/jQuery.isArray.xml | 2 +- entries/jQuery.isFunction.xml | 2 +- entries/jQuery.isNumeric.xml | 2 +- entries/jQuery.isWindow.xml | 2 +- entries/jQuery.now.xml | 2 +- entries/jQuery.parseJSON.xml | 2 +- entries/jQuery.trim.xml | 2 +- entries/jQuery.type.xml | 2 +- entries/toggleClass.xml | 2 +- 10 files changed, 10 insertions(+), 10 deletions(-) diff --git a/entries/jQuery.fx.interval.xml b/entries/jQuery.fx.interval.xml index ddcf4296..b86516c3 100644 --- a/entries/jQuery.fx.interval.xml +++ b/entries/jQuery.fx.interval.xml @@ -1,5 +1,5 @@ - + jQuery.fx.interval The rate (in milliseconds) at which animations fire. diff --git a/entries/jQuery.isArray.xml b/entries/jQuery.isArray.xml index 6ce958df..9891126f 100644 --- a/entries/jQuery.isArray.xml +++ b/entries/jQuery.isArray.xml @@ -1,5 +1,5 @@ - + jQuery.isArray() 1.3 diff --git a/entries/jQuery.isFunction.xml b/entries/jQuery.isFunction.xml index 3524ace2..5160f0a7 100644 --- a/entries/jQuery.isFunction.xml +++ b/entries/jQuery.isFunction.xml @@ -1,5 +1,5 @@ - + jQuery.isFunction() 1.2 diff --git a/entries/jQuery.isNumeric.xml b/entries/jQuery.isNumeric.xml index 7e64d4b7..c4fe4a72 100644 --- a/entries/jQuery.isNumeric.xml +++ b/entries/jQuery.isNumeric.xml @@ -1,5 +1,5 @@ - + jQuery.isNumeric() Determines whether its argument represents a JavaScript number. diff --git a/entries/jQuery.isWindow.xml b/entries/jQuery.isWindow.xml index e79a95a7..76a58f17 100644 --- a/entries/jQuery.isWindow.xml +++ b/entries/jQuery.isWindow.xml @@ -1,5 +1,5 @@ - + jQuery.isWindow() 1.4.3 diff --git a/entries/jQuery.now.xml b/entries/jQuery.now.xml index b482637c..00992aba 100644 --- a/entries/jQuery.now.xml +++ b/entries/jQuery.now.xml @@ -1,5 +1,5 @@ - + jQuery.now() 1.4.3 diff --git a/entries/jQuery.parseJSON.xml b/entries/jQuery.parseJSON.xml index a3249174..2023ebc8 100644 --- a/entries/jQuery.parseJSON.xml +++ b/entries/jQuery.parseJSON.xml @@ -1,5 +1,5 @@ - + diff --git a/entries/jQuery.trim.xml b/entries/jQuery.trim.xml index 6732a155..cfc537b6 100644 --- a/entries/jQuery.trim.xml +++ b/entries/jQuery.trim.xml @@ -1,5 +1,5 @@ - + jQuery.trim() 1.0 diff --git a/entries/jQuery.type.xml b/entries/jQuery.type.xml index b9ce8a8e..4dd56897 100644 --- a/entries/jQuery.type.xml +++ b/entries/jQuery.type.xml @@ -1,5 +1,5 @@ - + jQuery.type() 1.4.3 diff --git a/entries/toggleClass.xml b/entries/toggleClass.xml index da2c894f..b42f2329 100644 --- a/entries/toggleClass.xml +++ b/entries/toggleClass.xml @@ -229,7 +229,7 @@ $( "a" ).on( "click", function( event ) { - + 1.4 From 635f5ff2e0311f389ff4f803d3cdd5017c0cab0c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?= Date: Mon, 3 Mar 2025 18:58:07 +0100 Subject: [PATCH 20/40] All: Mark ajax event shorthands as deprecated in 3.5, not 3.3 jQuery 3.3.0 deprecated regular event shorthands: https://blog.jquery.com/2018/01/19/jquery-3-3-0-a-fragrant-bouquet-of-deprecations-and-is-that-a-new-feature/ The AJAX ones only got deprecated in 3.5: https://blog.jquery.com/2020/04/10/jquery-3-5-0-released/ Interstingly, the AJAX shorthands were already added to the `deprecated/deprecated-3.5` category, only the `deprecated` attribute was set incorrectly. Closes gh-1268 --- entries/ajaxComplete-shorthand.xml | 2 +- entries/ajaxError-shorthand.xml | 2 +- entries/ajaxSend-shorthand.xml | 2 +- entries/ajaxStart-shorthand.xml | 2 +- entries/ajaxStop-shorthand.xml | 2 +- entries/ajaxSuccess-shorthand.xml | 2 +- 6 files changed, 6 insertions(+), 6 deletions(-) diff --git a/entries/ajaxComplete-shorthand.xml b/entries/ajaxComplete-shorthand.xml index 8e9cc6bf..3f44abc1 100644 --- a/entries/ajaxComplete-shorthand.xml +++ b/entries/ajaxComplete-shorthand.xml @@ -1,5 +1,5 @@ - + .ajaxComplete() Register a handler to be called when Ajax requests complete. This is an AjaxEvent. diff --git a/entries/ajaxError-shorthand.xml b/entries/ajaxError-shorthand.xml index c1794365..f36ac54a 100644 --- a/entries/ajaxError-shorthand.xml +++ b/entries/ajaxError-shorthand.xml @@ -1,5 +1,5 @@ - + .ajaxError() Register a handler to be called when Ajax requests complete with an error. This is an Ajax Event. diff --git a/entries/ajaxSend-shorthand.xml b/entries/ajaxSend-shorthand.xml index 37d39222..a9ae031e 100644 --- a/entries/ajaxSend-shorthand.xml +++ b/entries/ajaxSend-shorthand.xml @@ -1,5 +1,5 @@ - + .ajaxSend() Attach a function to be executed before an Ajax request is sent. This is an Ajax Event. diff --git a/entries/ajaxStart-shorthand.xml b/entries/ajaxStart-shorthand.xml index 496152b3..51b2fc9e 100644 --- a/entries/ajaxStart-shorthand.xml +++ b/entries/ajaxStart-shorthand.xml @@ -1,5 +1,5 @@ - + .ajaxStart() Register a handler to be called when the first Ajax request begins. This is an Ajax Event. diff --git a/entries/ajaxStop-shorthand.xml b/entries/ajaxStop-shorthand.xml index d5fe7f30..78121657 100644 --- a/entries/ajaxStop-shorthand.xml +++ b/entries/ajaxStop-shorthand.xml @@ -1,5 +1,5 @@ - + .ajaxStop() Register a handler to be called when all Ajax requests have completed. This is an Ajax Event. diff --git a/entries/ajaxSuccess-shorthand.xml b/entries/ajaxSuccess-shorthand.xml index 95fa6e0e..a9e54335 100644 --- a/entries/ajaxSuccess-shorthand.xml +++ b/entries/ajaxSuccess-shorthand.xml @@ -1,5 +1,5 @@ - + .ajaxSuccess() Attach a function to be executed whenever an Ajax request completes successfully. This is an Ajax Event. From 6ed3adb842bdabd13a794fbc8297c53c7abc126d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?= Date: Mon, 24 Mar 2025 17:54:05 +0100 Subject: [PATCH 21/40] css: Document no auto-appending `px` in jQuery 4.0 Also, document the removal of `jQuery.cssNumber` in jQuery 4.0. Closes gh-1261 --- entries/css.xml | 12 +++++++- entries/jQuery.cssNumber.xml | 54 ++++++++++++++++++++++++------------ 2 files changed, 48 insertions(+), 18 deletions(-) diff --git a/entries/css.xml b/entries/css.xml index 7d6bd56e..85a304e8 100644 --- a/entries/css.xml +++ b/entries/css.xml @@ -108,6 +108,7 @@ $( "div" ).on( "click", function() { + @@ -146,7 +147,15 @@ $( "div" ).on( "click", function() {

As with the .prop() method, the .css() method makes setting properties of elements quick and easy. This method can take either a property name and value as separate parameters, or a single object of key-value pairs.

Also, jQuery can equally interpret the CSS and DOM formatting of multiple-word properties. For example, jQuery understands and returns the correct value for both .css({ "background-color": "#ffe", "border-left": "5px solid #ccc" }) and .css({backgroundColor: "#ffe", borderLeft: "5px solid #ccc" }). Notice that with the DOM notation, quotation marks around the property names are optional, but with CSS notation they're required due to the hyphen in the name.

-

When a number is passed as the value, jQuery will convert it to a string and add px to the end of that string. If the property requires units other than px, convert the value to a string and add the appropriate units before calling the method.

+

In jQuery 3.x or older, when a number is passed as the value, jQuery will convert it to a string and add px to the end of that string. However, there are exceptions. px is not added to keys of jQuery.cssNumber If the property requires units other than px, convert the value to a string and add the appropriate units before calling the method.

+

In jQuery 4.0 or newer, when a number is passed as the value, jQuery will only convert it to a string and add px to the end of that string for a limited set of properties - mostly related to width, height, border, margin & padding; the full list:

+
    +
  • setting the element position: top, right, bottom, left
  • +
  • setting the element dimensions: width, height, min-width, min-height, max-width, max-height
  • +
  • padding-related: padding, padding-top, padding-right, padding-bottom, padding-left
  • +
  • margin-related: margin, margin-top, margin-right, margin-bottom, margin-left
  • +
  • border-related: border, border-width, border-top, border-top-width, border-right, border-right-width, border-bottom, border-bottom-width, border-left, border-left-width
  • +

When using .css() as a setter, jQuery modifies the element's style property. For example, $( "#mydiv" ).css( "color", "green" ) is equivalent to document.getElementById( "mydiv" ).style.color = "green". Setting the value of a style property to an empty string — e.g. $( "#mydiv" ).css( "color", "" ) — removes that property from an element if it has already been directly applied, whether in the HTML style attribute, through jQuery's .css() method, or through direct DOM manipulation of the style property. As a consequence, the element's style for that property will be restored to whatever value was applied. So, this method can be used to cancel any style modification you have previously performed. It does not, however, remove a style that has been applied with a CSS rule in a stylesheet or <style> element. Warning: one notable exception is that, for IE 8 and below, removing a shorthand property such as border or background will remove that style entirely from the element, regardless of what is set in a stylesheet or <style> element.

Note: .css() doesn't support !important declarations. So, the statement $( "p" ).css( "color", "red !important" ) does not turn the color of all paragraphs in the page to red as of jQuery 3.6.0. Do not depend on that not working, though, as a future version of jQuery may add support for such declarations. It's strongly advised to use classes instead; otherwise use a jQuery plugin.

As of jQuery 1.8, the .css() setter will automatically take care of prefixing the property name. For example, take .css( "user-select", "none" ) in Chrome/Safari will set it as -webkit-user-select, Firefox will use -moz-user-select, and IE10 will use -ms-user-select.

@@ -286,5 +295,6 @@ $( "div" ).on( "click", function() { +
diff --git a/entries/jQuery.cssNumber.xml b/entries/jQuery.cssNumber.xml index ce5af886..c49b3c78 100644 --- a/entries/jQuery.cssNumber.xml +++ b/entries/jQuery.cssNumber.xml @@ -1,30 +1,50 @@ - + jQuery.cssNumber 1.4.3 - An object containing all CSS properties that may be used without a unit. The .css() method uses this object to see if it may append px to unitless values. + An object containing all CSS properties that may be used without a unit. Prior to jQuery 4.0, the .css() method uses this object to see if it may append px to unitless values. -

You can think about jQuery.cssNumber as a list of all CSS properties you might use without a unit. It's used by .css() to determine if it needs to add px to unitless values.

-

The keys of the jQuery.cssNumber object are camel-cased and the values are all set to true. If you want to prevent the .css() method from automatically adding the px unit for a specific CSS property, you can add an extra property to the jQuery.cssNumber object.

+
+

Note: This API has been removed in jQuery 4.0; please pass a string value with the desired units instead.

+
+

You can think about jQuery.cssNumber as a list of all CSS properties you might use without a unit. Prior to jQuery 4.0, it was used by .css() to determine if it needs to add px to unitless values.

+

The keys of the jQuery.cssNumber object are camel-cased and the values are all set to true. If you want to prevent the .css() method from automatically adding the px unit for a specific CSS property and that property is not yet a key of the jQuery.cssNumber object, you can add such an extra property:


-jQuery.cssNumber.someCSSProp = true;
+if ( jQuery.cssNumber ) {
+  jQuery.cssNumber.someCSSProp = true;
+}
     

By default the object contains the following properties:

    -
  • zIndex
  • -
  • fontWeight
  • -
  • opacity
  • -
  • zoom
  • -
  • lineHeight
  • -
  • widows (added in jQuery 1.6)
  • -
  • orphans (added in jQuery 1.6)
  • -
  • fillOpacity (added in jQuery 1.6.2)
  • -
  • columnCount (added in jQuery 1.9)
  • -
  • order (added in jQuery 1.10.2)
  • -
  • flexGrow (added in jQuery 1.11.1)
  • -
  • flexShrink (added in jQuery 1.11.1)
  • +
  • animationIterationCount (added in 1.12.0/2.2.0)
  • +
  • aspectRatio (added in 3.7.0)
  • +
  • borderImageSlice (added in 3.7.0)
  • +
  • columnCount (added in 1.9.0)
  • +
  • flexGrow (added in 1.11.1/2.1.1)
  • +
  • flexShrink (added in 1.11.1/2.1.1)
  • +
  • fontWeight (added in 1.4.3)
  • +
  • gridArea (added in 3.4.0)
  • +
  • gridColumn (added in 3.4.0)
  • +
  • gridColumnEnd (added in 3.4.0)
  • +
  • gridColumnStart (added in 3.4.0)
  • +
  • gridRow (added in 3.4.0)
  • +
  • gridRowEnd (added in 3.4.0)
  • +
  • gridRowStart (added in 3.4.0)
  • +
  • lineHeight (added in 1.4.3)
  • +
  • opacity (added in 1.4.3)
  • +
  • order (added in 1.10.2/2.0.3)
  • +
  • orphans (added in 1.6.0)
  • +
  • scale (added in 3.7.0)
  • +
  • widows (added in 1.6.0)
  • +
  • zIndex (added in 1.4.3)
  • +
  • zoom (added in 1.4.3)
  • +
  • fillOpacity (SVG-related, added in 1.6.2)
  • +
  • floodOpacity (SVG-related, added in 3.7.0)
  • +
  • stopOpacity (SVG-related, added in 3.7.0)
  • +
  • strokeMiterlimit (SVG-related, added in 3.7.0)
  • +
  • strokeOpacity (SVG-related, added in 3.7.0)
From df921c4bf2c233d0c2b0eff7ac82ad42fd5088f9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?= Date: Mon, 24 Mar 2025 17:56:19 +0100 Subject: [PATCH 22/40] 3.3.7 --- package-lock.json | 4 ++-- package.json | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/package-lock.json b/package-lock.json index 1abf8278..15492ea3 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "api.jquery.com", - "version": "3.3.6", + "version": "3.3.7", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "api.jquery.com", - "version": "3.3.6", + "version": "3.3.7", "dependencies": { "grunt": "1.6.1", "grunt-jquery-content": "3.3.1" diff --git a/package.json b/package.json index 1e27f2f0..273113fb 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "api.jquery.com", - "version": "3.3.6", + "version": "3.3.7", "private": true, "scripts": { "test": "grunt lint" From 6316ba1ce65c83f4aef63e5a07b9172e6f8c8522 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Aldimar=20J=C3=BAnior?= <98884282+aldimar-junior@users.noreply.github.com> Date: Tue, 1 Apr 2025 18:05:05 -0300 Subject: [PATCH 23/40] ajaxSuccess: Fix a typo in an example code block Closes gh-1270 --- entries/ajaxSuccess.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/entries/ajaxSuccess.xml b/entries/ajaxSuccess.xml index e92a1269..8824a621 100644 --- a/entries/ajaxSuccess.xml +++ b/entries/ajaxSuccess.xml @@ -55,7 +55,7 @@ $( document ).on( "ajaxSuccess", function( event, xhr, settings ) { Show a message when an Ajax request completes successfully. From fbc2602c8fd78be1f40da7b56031d46fde81600c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?= Date: Tue, 1 Apr 2025 23:05:28 +0200 Subject: [PATCH 24/40] 3.3.8 --- package-lock.json | 4 ++-- package.json | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/package-lock.json b/package-lock.json index 15492ea3..f13dceac 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "api.jquery.com", - "version": "3.3.7", + "version": "3.3.8", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "api.jquery.com", - "version": "3.3.7", + "version": "3.3.8", "dependencies": { "grunt": "1.6.1", "grunt-jquery-content": "3.3.1" diff --git a/package.json b/package.json index 273113fb..46c11ef4 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "api.jquery.com", - "version": "3.3.7", + "version": "3.3.8", "private": true, "scripts": { "test": "grunt lint" From 1e095c58854ba27ea210d3ae85f36549b960a5cb Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 2 Apr 2025 14:20:26 +0200 Subject: [PATCH 25/40] Build: Bump actions/setup-node in the github-actions group Bumps the github-actions group with 1 update: [actions/setup-node](https://github.com/actions/setup-node). Closes gh-1269 Updates `actions/setup-node` from 4.2.0 to 4.3.0 - [Release notes](https://github.com/actions/setup-node/releases) - [Commits](https://github.com/actions/setup-node/compare/1d0ff469b7ec7b3cb9d8673fde0c81c44821de2a...cdca7365b2dadb8aad0a33bc7601856ffabcc48e) --- updated-dependencies: - dependency-name: actions/setup-node dependency-type: direct:production update-type: version-update:semver-minor dependency-group: github-actions ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- .github/workflows/node.js.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/node.js.yml b/.github/workflows/node.js.yml index e9d2fe6c..26f673d8 100644 --- a/.github/workflows/node.js.yml +++ b/.github/workflows/node.js.yml @@ -22,7 +22,7 @@ jobs: - name: Install xmllint run: sudo apt-get install -y libxml2-utils - name: Use Node.js ${{ matrix.node-version }} - uses: actions/setup-node@1d0ff469b7ec7b3cb9d8673fde0c81c44821de2a # v4.2.0 + uses: actions/setup-node@cdca7365b2dadb8aad0a33bc7601856ffabcc48e # v4.3.0 with: node-version: ${{ matrix.node-version }} cache: 'npm' From 22f2e65bb261fd48452919e6762e66b363a78453 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Aldimar=20J=C3=BAnior?= <98884282+aldimar-junior@users.noreply.github.com> Date: Tue, 8 Apr 2025 09:54:14 -0300 Subject: [PATCH 26/40] keypress: Fix typos: keyup -> keypress Fixes gh-1266 Closes gh-1272 --- entries/keypress.xml | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/entries/keypress.xml b/entries/keypress.xml index 16cf4303..089765bf 100644 --- a/entries/keypress.xml +++ b/entries/keypress.xml @@ -7,8 +7,8 @@ Bind an event handler to the "keypress" event. 1.7 - - The string "keyup". + + The string "keypress". An object containing data that will be passed to the event handler. @@ -113,16 +113,16 @@ $( "#other" ).on( "click", function() {
- keyup event - Trigger the "keyup" event on an element. + keypress event + Trigger the "keypress" event on an element. 1.0 - - The string "keyup". + + The string "keypress". -

See the description for .on( "keyup", ... ).

+

See the description for .on( "keypress", ... ).

From a798da061e29ecf8741077fce1e08135ea55b54f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Aldimar=20J=C3=BAnior?= <98884282+aldimar-junior@users.noreply.github.com> Date: Tue, 8 Apr 2025 09:56:46 -0300 Subject: [PATCH 27/40] text: Change wording from "cannot" to "should not" You can use `.text()` on an input, you just shouldn't do this as the behavior may not be expected. Fixes gh-1244 Closes gh-1273 --- entries/text.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/entries/text.xml b/entries/text.xml index ff9c537e..616b8a2c 100644 --- a/entries/text.xml +++ b/entries/text.xml @@ -22,7 +22,7 @@

Demonstration Box list item 1 list item 2

-

The .text() method cannot be used on form inputs or scripts. To set or get the text value of input or textarea elements, use the .val() method. To get the value of a script element, use the .html() method.

+

The .text() method should not be used on form inputs or scripts. To set or get the text value of input or textarea elements, use the .val() method. To get the value of a script element, use the .html() method.

As of jQuery 1.4, the .text() method returns the value of text and CDATA nodes as well as element nodes.

@@ -91,7 +91,7 @@ $( "p" ).last().html( str );

 <p>This is a test</p>
       
-

The .text() method cannot be used on input elements. For input field text, use the .val() method.

+

The .text() method should not be used on input elements. For input field text, use the .val() method.

As of jQuery 1.4, the .text() method allows us to set the text content by passing in a function.


 $( "ul li" ).text(function( index ) {

From 49f21dd6ce64813d74523c10d99647b43f8f35c1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Tue, 8 Apr 2025 15:40:22 +0200
Subject: [PATCH 28/40] 3.3.9

---
 package-lock.json | 4 ++--
 package.json      | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index f13dceac..53d9d90d 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "api.jquery.com",
-  "version": "3.3.8",
+  "version": "3.3.9",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "api.jquery.com",
-      "version": "3.3.8",
+      "version": "3.3.9",
       "dependencies": {
         "grunt": "1.6.1",
         "grunt-jquery-content": "3.3.1"
diff --git a/package.json b/package.json
index 46c11ef4..76acba32 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.3.8",
+  "version": "3.3.9",
   "private": true,
   "scripts": {
     "test": "grunt lint"

From ff7994e06ba7386744461d6d85d594c2d1c71ce1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?=
 
Date: Sat, 12 Apr 2025 19:11:24 +0200
Subject: [PATCH 29/40] Build: Skip checking oembed wp-json links in the hydra
 crawler (#1275)

The oembed endpoint responds HTTP 429 Too Many Requests too often; perhaps
because almost every page links to one.

Also, run the spider check on PRs that modify the hydra config file.
---
 .github/configs/hydra-config.json   | 7 ++++++-
 .github/workflows/spider-check.yaml | 2 ++
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/.github/configs/hydra-config.json b/.github/configs/hydra-config.json
index 3d367e7b..2173722b 100644
--- a/.github/configs/hydra-config.json
+++ b/.github/configs/hydra-config.json
@@ -1,5 +1,10 @@
 {
+  "//": [
+    "2023-05: twitter.com serves broken redirect-loop",
+    "2025-04: The oembed endpoint responds HTTP 429 Too Many Requests too often; perhaps because almost every page links to one"
+  ],
   "exclude_scheme_prefixes": [
-    "https://twitter.com/"
+    "https://twitter.com/",
+    "https://api.jquery.com/wp-json/oembed/1.0/embed"
   ]
 }
diff --git a/.github/workflows/spider-check.yaml b/.github/workflows/spider-check.yaml
index 378da3db..95ea1ea2 100644
--- a/.github/workflows/spider-check.yaml
+++ b/.github/workflows/spider-check.yaml
@@ -9,9 +9,11 @@ on:
   push:
     paths:
       - .github/workflows/spider-check.yaml
+      - .github/configs/hydra-config.json
   pull_request:
     paths:
       - .github/workflows/spider-check.yaml
+      - .github/configs/hydra-config.json
 
 jobs:
   spider-check:

From f82640728745247731939152651fbcd2f61e57ee Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Mon, 14 Apr 2025 19:04:56 +0200
Subject: [PATCH 30/40] Build: Bump grunt-jquery-content from 3.3.1 to 3.3.2

Ref jquery/grunt-jquery-content#95
Fixes jquery/api.jquery.com#1157
---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 76acba32..dc794408 100644
--- a/package.json
+++ b/package.json
@@ -7,6 +7,6 @@
   },
   "dependencies": {
     "grunt": "1.6.1",
-    "grunt-jquery-content": "3.3.1"
+    "grunt-jquery-content": "3.3.2"
   }
 }

From ad06685480d1a61b472ca55b1171685f96c4c2c4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Mon, 14 Apr 2025 19:07:08 +0200
Subject: [PATCH 31/40] Build: Update package-lock.json

The previous commit only updated `package.json`, making `npm ci` fail.
---
 package-lock.json | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 53d9d90d..0bd3d949 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -9,7 +9,7 @@
       "version": "3.3.9",
       "dependencies": {
         "grunt": "1.6.1",
-        "grunt-jquery-content": "3.3.1"
+        "grunt-jquery-content": "3.3.2"
       }
     },
     "node_modules/abbrev": {
@@ -504,9 +504,9 @@
       }
     },
     "node_modules/grunt-jquery-content": {
-      "version": "3.3.1",
-      "resolved": "https://registry.npmjs.org/grunt-jquery-content/-/grunt-jquery-content-3.3.1.tgz",
-      "integrity": "sha512-aK4DdMYkM+qjSyXkEswvlSTHqcWDfvKKjWveeDLK/dIM1Ok7iXGd1SwFuFp2ShO+rx9XEHToX3KC5+Gn2BwAug==",
+      "version": "3.3.2",
+      "resolved": "https://registry.npmjs.org/grunt-jquery-content/-/grunt-jquery-content-3.3.2.tgz",
+      "integrity": "sha512-b6w8GBe022BG8O7BkhAKBFcBBAldoIiwAUZ2WI+A8HIouXy8XS8Cwp2RuUPEACg3g2/wHOarmjrsFKFPmmZ55Q==",
       "dependencies": {
         "cheerio": "^1.0.0-rc.12",
         "gilded-wordpress": "1.0.7",

From 764a156f78c28036673e52dbb3c133e0cbaa82aa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Mon, 14 Apr 2025 19:09:34 +0200
Subject: [PATCH 32/40] 3.3.10

---
 package-lock.json | 4 ++--
 package.json      | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 0bd3d949..0da24ae3 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "api.jquery.com",
-  "version": "3.3.9",
+  "version": "3.3.10",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "api.jquery.com",
-      "version": "3.3.9",
+      "version": "3.3.10",
       "dependencies": {
         "grunt": "1.6.1",
         "grunt-jquery-content": "3.3.2"
diff --git a/package.json b/package.json
index dc794408..c86c045c 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.3.9",
+  "version": "3.3.10",
   "private": true,
   "scripts": {
     "test": "grunt lint"

From ebb139afdce04e33666b9876945678acfcabdba7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?=
 
Date: Mon, 14 Apr 2025 22:23:17 +0200
Subject: [PATCH 33/40] All: Update the link to html5shiv

Change the html5shiv link from https://code.google.com/p/html5shiv/ to
https://github.com/afarkas/html5shiv to which the former already 301-redirects.

We've had some code.google.com-related spider-check crawler errors which this
may also eliminate.

Ref gh-1275
---
 entries/html.xml   | 2 +-
 entries/jQuery.xml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/html.xml b/entries/html.xml
index 0eae2f74..1a29d361 100644
--- a/entries/html.xml
+++ b/entries/html.xml
@@ -118,7 +118,7 @@ $( "div.demo-container" ).html(function() {
 });
       

Given a document with six paragraphs, this example will set the HTML of <div class="demo-container"> to <p>All new content for <em>6 paragraphs!</em></p>.

-

This method uses the browser's innerHTML property. Some browsers may not generate a DOM that exactly replicates the HTML source provided. For example, Internet Explorer prior to version 8 will convert all href properties on links to absolute URLs, and Internet Explorer prior to version 9 will not correctly handle HTML5 elements without the addition of a separate compatibility layer.

+

This method uses the browser's innerHTML property. Some browsers may not generate a DOM that exactly replicates the HTML source provided. For example, Internet Explorer prior to version 8 will convert all href properties on links to absolute URLs, and Internet Explorer prior to version 9 will not correctly handle HTML5 elements without the addition of a separate compatibility layer.

To set the content of a <script> element, which does not contain HTML, use the .text() method and not .html().

Note: In Internet Explorer up to and including version 9, setting the text content of an HTML element may corrupt the text nodes of its children that are being removed from the document as a result of the operation. If you are keeping references to these DOM elements and need them to be unchanged, use .empty().html( string ) instead of .html(string) so that the elements are removed from the document before the new string is assigned to the element.

diff --git a/entries/jQuery.xml b/entries/jQuery.xml index 398f10b4..8df77906 100644 --- a/entries/jQuery.xml +++ b/entries/jQuery.xml @@ -178,7 +178,7 @@ $( myForm.elements ).hide();

By default, elements are created with an .ownerDocument matching the document into which the jQuery library was loaded. Elements being injected into a different document should be created using that document, e.g., $("<p>hello iframe</p>", $("#myiframe").prop("contentWindow").document).

If the HTML is more complex than a single tag without attributes, as it is in the above example, the actual creation of the elements is handled by the browser's .innerHTML mechanism. In most cases, jQuery creates a new <div> element and sets the innerHTML property of the element to the HTML snippet that was passed in. When the parameter has a single tag (with optional closing tag or quick-closing) — $( "<img />" ) or $( "<img>" ), $( "<a></a>" ) or $( "<a>" ) — jQuery creates the element using the native JavaScript .createElement() function.

When passing in complex HTML, some browsers may not generate a DOM that exactly replicates the HTML source provided. As mentioned, jQuery uses the browser's .innerHTML property to parse the passed HTML and insert it into the current document. During this process, some browsers filter out certain elements such as <html>, <title>, or <head> elements. As a result, the elements inserted may not be representative of the original string passed.

-

Filtering isn't, however, limited to these tags. For example, Internet Explorer prior to version 8 will also convert all href properties on links to absolute URLs, and Internet Explorer prior to version 9 will not correctly handle HTML5 elements without the addition of a separate compatibility layer.

+

Filtering isn't, however, limited to these tags. For example, Internet Explorer prior to version 8 will also convert all href properties on links to absolute URLs, and Internet Explorer prior to version 9 will not correctly handle HTML5 elements without the addition of a separate compatibility layer.

To ensure cross-platform compatibility, the snippet must be well-formed. Tags that can contain other elements should be paired with a closing tag:

$( "<a href='https://jquery.com'></a>" );

Tags that cannot contain elements may be quick-closed or not:

From d394772f73d45c849f20110bbc48314846e80277 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sun, 4 May 2025 13:38:23 +0200 Subject: [PATCH 34/40] Build: Bump actions/setup-node in the github-actions group Bumps the github-actions group with 1 update: [actions/setup-node](https://github.com/actions/setup-node). Closes gh-1278 Updates `actions/setup-node` from 4.3.0 to 4.4.0 - [Release notes](https://github.com/actions/setup-node/releases) - [Commits](https://github.com/actions/setup-node/compare/cdca7365b2dadb8aad0a33bc7601856ffabcc48e...49933ea5288caeca8642d1e84afbd3f7d6820020) --- updated-dependencies: - dependency-name: actions/setup-node dependency-version: 4.4.0 dependency-type: direct:production update-type: version-update:semver-minor dependency-group: github-actions ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- .github/workflows/node.js.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/node.js.yml b/.github/workflows/node.js.yml index 26f673d8..ca2b79e7 100644 --- a/.github/workflows/node.js.yml +++ b/.github/workflows/node.js.yml @@ -22,7 +22,7 @@ jobs: - name: Install xmllint run: sudo apt-get install -y libxml2-utils - name: Use Node.js ${{ matrix.node-version }} - uses: actions/setup-node@cdca7365b2dadb8aad0a33bc7601856ffabcc48e # v4.3.0 + uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0 with: node-version: ${{ matrix.node-version }} cache: 'npm' From 669793dd587dbd15c9ced6d25442c8d3506208a7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?= Date: Mon, 5 May 2025 18:00:45 +0200 Subject: [PATCH 35/40] All: Create pages for `jQuery.Deferred.{getErrorHook,exceptionHook}` Also, create a page for the now deprecated `jQuery.Deferred.getStackHook`. Fixes gh-1221 Fixes gh-1246 Closes gh-1277 --- categories.xml | 6 ++++ entries/jQuery.Deferred.exceptionHook.xml | 34 +++++++++++++++++++++++ entries/jQuery.Deferred.getErrorHook.xml | 29 +++++++++++++++++++ entries/jQuery.Deferred.getStackHook.xml | 30 ++++++++++++++++++++ 4 files changed, 99 insertions(+) create mode 100644 entries/jQuery.Deferred.exceptionHook.xml create mode 100644 entries/jQuery.Deferred.getErrorHook.xml create mode 100644 entries/jQuery.Deferred.getStackHook.xml diff --git a/categories.xml b/categories.xml index 8dc523ec..0f7d4df1 100644 --- a/categories.xml +++ b/categories.xml @@ -108,6 +108,12 @@

For more information, see the Release Notes/Changelog at https://blog.jquery.com/2020/04/10/jquery-3-5-0-released/

]]>
+ + +
diff --git a/entries/jQuery.Deferred.exceptionHook.xml b/entries/jQuery.Deferred.exceptionHook.xml new file mode 100644 index 00000000..db6c3226 --- /dev/null +++ b/entries/jQuery.Deferred.exceptionHook.xml @@ -0,0 +1,34 @@ + + + jQuery.Deferred.exceptionHook() + + 3.0 + + Handle errors produced by Deferreds. + +

This API is called every time an error is thrown inside Deferreds. By default, it only warns about errors that are more likely to be programmer errors than errors thrown due to application logic. This includes errors like SyntaxError or ReferenceError.

+

The function accepts two parameters - the first one is the error thrown and the second, optional parameter is a "fake" error created before the handler is called so that a stack trace from before an async barrier is available. This second error is only provided if jQuery.Deferred.getErrorHook is defined; see the docs for that API for more details.

+

Example

+
+
+ + +
diff --git a/entries/jQuery.Deferred.getErrorHook.xml b/entries/jQuery.Deferred.getErrorHook.xml new file mode 100644 index 00000000..b20f98e8 --- /dev/null +++ b/entries/jQuery.Deferred.getErrorHook.xml @@ -0,0 +1,29 @@ + + + jQuery.Deferred.getErrorHook() + + 3.7 + + Return an Error instance with a defined stack. + +
+

Note: This API is not defined by default, but jQuery will make use of it when defined.

+
+

When jQuery.Deferred.getErrorHook is defined, it extends the jQuery.Deferred features added in jQuery 3.0 to include an error captured before the async barrier whenever a Deferred throws an exception. This makes it easier to find programming errors that occur inside Deferreds. You can find an example implementation you can copy-paste below, or you can use jquery-deferred-reporter plugin.

+

+jQuery.Deferred.getErrorHook = function() {
+  try {
+    throw new Error( "Exception in jQuery.Deferred" );
+  } catch ( err ) {
+    return err;
+  }
+};
+    
+

When defined, an error returned by this API is passed to jQuery.Deferred.exceptionHook as the second parameter.

+

Why does this API exist?

+

Prior to jQuery 3.0, Deferreds would simply terminate and the browser would generate a message on the console if an exception occurred such as attempting to call an undefined method as a function (e.g., myobject.missingFunction()). As of version 3.0, jQuery.Deferred follows the Promise/A+ specification when you use the .then method. The spec requires all errors to be trapped by the Promise, which prevents console errors from being logged. If the user has forgotten to add a handler for rejected promises, this can result in the error being silently swallowed with no notification at all!

+

The native Promise object as implemented in the browser tracks Promise rejections and reports problems on the console. However, doing the same type of reporting in the JavaScript world is much more difficult. jQuery itself is unable to use the native Promise because jQuery.Deferred implements a superset of Promise that requires additional features for methods like .done or .fail, and because Promise is not implemented on all the platforms that jQuery supports.

+
+ + +
diff --git a/entries/jQuery.Deferred.getStackHook.xml b/entries/jQuery.Deferred.getStackHook.xml new file mode 100644 index 00000000..e4044da8 --- /dev/null +++ b/entries/jQuery.Deferred.getStackHook.xml @@ -0,0 +1,30 @@ + + + jQuery.Deferred.getStackHook() + + 3.0 + + Return an Error instance with a defined stack. + +
+

Note: This API has been deprecated in jQuery 3.7; please use the jQuery.Deferred.getErrorHook method instead.

+
+
+

Note: This API is not defined by default. It may be provided by the user and jQuery will then use it internally.

+
+

See jQuery.Deferred.getErrorHook for the context why this API was created. Initially, we advised users to assign to it a function returning an error stack:

+

+jQuery.Deferred.getStackHook = function() {
+  try {
+    throw new Error( "Exception in jQuery.Deferred" );
+  } catch ( err ) {
+    return err.stack; // stack property returned here
+  }
+};
+    
+

However, when such a stack is then logged by jQuery from inside of jQuery.Deferred.exceptionHook, the browser won't apply source maps. Therefore, we changed the recommendation to return the full error object itself. To make it clearer, the API was also renamed.

+
+ + + +
From 5ba1c220a118b969dce65c6224e57620b061d7cf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?= Date: Mon, 5 May 2025 18:05:18 +0200 Subject: [PATCH 36/40] jQuery.Deferred.getStackHook: Make the note match the `getErrorHook` one Ref gh-1277 --- entries/jQuery.Deferred.getStackHook.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/entries/jQuery.Deferred.getStackHook.xml b/entries/jQuery.Deferred.getStackHook.xml index e4044da8..87ee6138 100644 --- a/entries/jQuery.Deferred.getStackHook.xml +++ b/entries/jQuery.Deferred.getStackHook.xml @@ -10,7 +10,7 @@

Note: This API has been deprecated in jQuery 3.7; please use the jQuery.Deferred.getErrorHook method instead.

-

Note: This API is not defined by default. It may be provided by the user and jQuery will then use it internally.

+

Note: This API is not defined by default, but jQuery will make use of it when defined.

See jQuery.Deferred.getErrorHook for the context why this API was created. Initially, we advised users to assign to it a function returning an error stack:



From da0d1e1e4741695fbcca5957cdb01ea152dec5fd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Mon, 5 May 2025 18:05:36 +0200
Subject: [PATCH 37/40] 3.3.11

---
 package-lock.json | 4 ++--
 package.json      | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 0da24ae3..35b33aeb 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "api.jquery.com",
-  "version": "3.3.10",
+  "version": "3.3.11",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "api.jquery.com",
-      "version": "3.3.10",
+      "version": "3.3.11",
       "dependencies": {
         "grunt": "1.6.1",
         "grunt-jquery-content": "3.3.2"
diff --git a/package.json b/package.json
index c86c045c..0d874d2f 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.3.10",
+  "version": "3.3.11",
   "private": true,
   "scripts": {
     "test": "grunt lint"

From fe17385a046eac8c20a6a001b1644de247e5dd87 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Mon, 12 May 2025 17:52:55 +0200
Subject: [PATCH 38/40] Build: Update the apt-get cache before installing any
 package

---
 .github/workflows/node.js.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/node.js.yml b/.github/workflows/node.js.yml
index ca2b79e7..30412870 100644
--- a/.github/workflows/node.js.yml
+++ b/.github/workflows/node.js.yml
@@ -19,6 +19,8 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+      - name: Update apt-get cache
+        run: sudo apt-get update
       - name: Install xmllint
         run: sudo apt-get install -y libxml2-utils
       - name: Use Node.js ${{ matrix.node-version }}

From eb10b09c554e459a1374cf17d8dac46e594d84c9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82=C4=99biowski-Owczarek?=
 
Date: Mon, 17 Oct 2022 18:52:48 +0200
Subject: [PATCH 39/40] jQuery.get:jQuery.post: Document issues with `data:
 null` with 3 params

In jQuery 3.x and older, when providing a `null` value for `success` you also
have to provide the `data` parameter; you can set it to `undefined`.

Document this restriction of `jQuery.get` & `jQuery.post`.

Closes gh-1208
Ref jquery/jquery#4989
Ref jquery/jquery#5139
Ref jquery/jquery#5640
Ref jquery/jquery#5645
Ref jquery/jquery#5646
---
 entries/jQuery.get.xml  | 2 +-
 entries/jQuery.post.xml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/entries/jQuery.get.xml b/entries/jQuery.get.xml
index 575a6f83..e0f7af6f 100644
--- a/entries/jQuery.get.xml
+++ b/entries/jQuery.get.xml
@@ -15,7 +15,7 @@
       
       
       
-      A callback function that is executed if the request succeeds. Required if dataType is provided, but you can use null or jQuery.noop as a placeholder.
+      A callback function that is executed if the request succeeds. Required if dataType is provided, but you can use null or jQuery.noop as a placeholder. NOTE: In jQuery 3.x and older, when providing a null value for success you also have to provide the data parameter; you can set it to null or undefined.
     
     
       The type of data expected from the server. Default: Intelligent Guess (xml, json, script, text, html).
diff --git a/entries/jQuery.post.xml b/entries/jQuery.post.xml
index e5411bed..e862071f 100644
--- a/entries/jQuery.post.xml
+++ b/entries/jQuery.post.xml
@@ -15,7 +15,7 @@
       
       
       
-      A callback function that is executed if the request succeeds. Required if dataType is provided, but can be null in that case.
+      A callback function that is executed if the request succeeds. Required if dataType is provided, but can be null or jQuery.noop as a placeholder. NOTE: In jQuery 3.x and older, when providing a null value for success you also have to provide the data parameter; you can set it to undefined.
     
     
       The type of data expected from the server. Default: Intelligent Guess (xml, json, script, text, html).

From 18a38d68029d2296cdb318b5f40e81a3e10092f1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 
Date: Mon, 12 May 2025 18:54:01 +0200
Subject: [PATCH 40/40] 3.3.12

---
 package-lock.json | 4 ++--
 package.json      | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 35b33aeb..e3b94705 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "api.jquery.com",
-  "version": "3.3.11",
+  "version": "3.3.12",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "api.jquery.com",
-      "version": "3.3.11",
+      "version": "3.3.12",
       "dependencies": {
         "grunt": "1.6.1",
         "grunt-jquery-content": "3.3.2"
diff --git a/package.json b/package.json
index 0d874d2f..458873ea 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "api.jquery.com",
-  "version": "3.3.11",
+  "version": "3.3.12",
   "private": true,
   "scripts": {
     "test": "grunt lint"
@@ -44,12 +44,19 @@ elem.getAttribute( "checked" ) "checked" (String) Initial state of the checkbox; does not change"" (String) Initial state of the checkbox; does not change
+ $( elem ).attr( "checked" ) + (4.0+) + "" (String) Initial state of the checkbox; does not change
$( elem ).attr( "checked" ) - (1.6+) + (1.6-3.x) "checked" (String) Initial state of the checkbox; does not change