Merge branch 'dev-3.0'

Author: birdofpreyru

.circleci/config.yml

@@ -19,22 +19,22 @@ version: 2.1
 jobs:
   test-node-20: # Maintenance LTS, EOL 2026.04.30
     docker:
-      - image: cimg/node:20.19
+      - image: cimg/node:20.20
     steps:
       *install-and-test
   test-node-22: # Maintenance LTS, EOL 2027.04.30
     docker:
-      - image: cimg/node:22.21
+      - image: cimg/node:22.22
     steps:
       *install-and-test
   test-node-24: # Active LTS, EOL 2028.04.30
     docker:
-      - image: cimg/node:24.12
+      - image: cimg/node:24.13
     steps:
       *install-and-test
   test-node-25: # Current, EOL 2026.06.01
     docker:
-      - image: cimg/node:25.2
+      - image: cimg/node:25.5
     steps:
       *install-and-test
   build-and-test:

.gitignore

@@ -2,3 +2,4 @@ __coverage__
 *.tgz
 build
 node_modules
+/.eslintcache

.nvmrc

@@ -1 +1 @@
-24.12.0
+24.13.0

README.md

@@ -19,6 +19,7 @@ successor of now unmaintained and stale
 [<img width=36 src="https://avatars.githubusercontent.com/u/17030877?v=4&s=36" />](https://github.com/RigoOnRails)
 
 ### [Contributors](https://github.com/birdofpreyru/react-helmet/graphs/contributors)
+[<img width=36 src="https://avatars.githubusercontent.com/u/5297725?v=4&s=36" />](https://github.com/vegerot)
 [<img width=36 src="https://avatars.githubusercontent.com/u/20144632?s=36" />](https://github.com/birdofpreyru)
 
 ## Table of Contents

__tests__/__snapshots__/misc.test.tsx.snap

@@ -27,3 +27,7 @@ exports[`misc Declarative API only adds new tags and preserves tags when renderi
 exports[`misc Declarative API only adds new tags and preserves tags when rendering additional Helmet instances 5`] = `"<meta content="Test description" name="description" data-rh="true">"`;
 
 exports[`misc Declarative API recognizes valid tags regardless of attribute ordering 1`] = `"<meta content="Test Description" name="description" data-rh="true">"`;
+
+exports[`misc Declarative API throws on invalid elements 1`] = `"Only elements types base, body, Symbol(react.fragment), head, html, link, meta, noscript, script, style, title are allowed. Helmet does not support rendering <div> elements. Refer to our API for more information."`;
+
+exports[`misc Declarative API throws on invalid self-closing elements 1`] = `"Only elements types base, body, Symbol(react.fragment), head, html, link, meta, noscript, script, style, title are allowed. Helmet does not support rendering <div> elements. Refer to our API for more information."`;

__tests__/api/base.test.tsx

@@ -1,8 +1,8 @@
 /** @jest-environment jsdom */
 
+import { renderClient } from '../../jest/browser-utils';
 import { Helmet } from '../../src';
 import { HELMET_ATTRIBUTE } from '../../src/constants';
-import { renderClient } from '../../jest/browser-utils';
 
 describe('base tag', () => {
   describe('API', () => {
@@ -30,8 +30,21 @@ describe('base tag', () => {
       expect(existingTags).toHaveLength(0);
     });
 
-    it('tags without \'href\' are not accepted', () => {
-      renderClient(<Helmet base={{ property: 'won\'t work' }} />);
+    it("tags with only 'target' are accepted", () => {
+      renderClient(<Helmet base={{ target: '_blank' }} />);
+      const existingTags = [...document.head.querySelectorAll(`base[${HELMET_ATTRIBUTE}]`)];
+
+      expect(existingTags).toBeDefined();
+      expect(existingTags).toHaveLength(1);
+      const firstTag = existingTags[0]!;
+      expect(firstTag).toBeInstanceOf(Element);
+      expect(firstTag.getAttribute).toBeDefined();
+      expect(firstTag).toHaveAttribute('target', '_blank');
+      expect(firstTag).not.toHaveAttribute('href');
+    });
+
+    it("tags without 'href' or 'target' are not accepted", () => {
+      renderClient(<Helmet base={{ property: "won't work" }} />);
       const existingTags = document.head.querySelectorAll(`base[${HELMET_ATTRIBUTE}]`);
 
       expect(existingTags).toBeDefined();
@@ -97,7 +110,25 @@ describe('base tag', () => {
       expect(existingTags).toHaveLength(0);
     });
 
-    it('tags without \'href\' are not accepted', () => {
+    it("tags with only 'target' are accepted", () => {
+      renderClient(
+        <Helmet>
+          <base target="_blank" />
+        </Helmet>,
+      );
+
+      const existingTags = [...document.head.querySelectorAll(`base[${HELMET_ATTRIBUTE}]`)];
+
+      expect(existingTags).toBeDefined();
+      expect(existingTags).toHaveLength(1);
+      const firstTag = existingTags[0]!;
+      expect(firstTag).toBeInstanceOf(Element);
+      expect(firstTag.getAttribute).toBeDefined();
+      expect(firstTag).toHaveAttribute('target', '_blank');
+      expect(firstTag).not.toHaveAttribute('href');
+    });
+
+    it("tags without 'href' or 'target' are not accepted", () => {
       /* eslint-disable react/no-unknown-property */
       renderClient(
         <Helmet>

__tests__/api/bodyAttributes.test.tsx

@@ -1,8 +1,8 @@
 /** @jest-environment jsdom */
 
+import { renderClient } from '../../jest/browser-utils';
 import { type BodyProps, Helmet } from '../../src';
 import { HELMET_ATTRIBUTE, HTML_TAG_MAP } from '../../src/constants';
-import { renderClient } from '../../jest/browser-utils';
 
 describe('body attributes', () => {
   describe('valid attributes', () => {

__tests__/api/client.test.tsx

@@ -1,14 +1,14 @@
 /** @jest-environment jsdom */
 
-import { type OnChangeClientState, Helmet } from '../../src';
-
 import { renderClient } from '../../jest/browser-utils';
 
+import { Helmet, type OnChangeClientState } from '../../src';
+
 describe('onChangeClientState', () => {
   describe('API', () => {
     // eslint-disable-next-line complexity
     it('when handling client state change, calls the function with new state, addedTags and removedTags', () => {
-      const onChange = jest.fn<unknown, Parameters<OnChangeClientState>>();
+      const onChange = jest.fn<undefined, Parameters<OnChangeClientState>>();
       renderClient(
         <div>
           <Helmet
@@ -105,7 +105,7 @@ describe('onChangeClientState', () => {
   describe('Declarative API', () => {
     // eslint-disable-next-line complexity
     it('when handling client state change, calls the function with new state, addedTags and removedTags', () => {
-      const onChange = jest.fn<unknown, Parameters<OnChangeClientState>>();
+      const onChange = jest.fn<undefined, Parameters<OnChangeClientState>>();
       renderClient(
         <div>
           <Helmet onChangeClientState={onChange}>

__tests__/api/htmlAttributes.test.tsx

@@ -1,8 +1,8 @@
 /** @jest-environment jsdom */
 
+import { renderClient } from '../../jest/browser-utils';
 import { Helmet } from '../../src';
 import { HELMET_ATTRIBUTE } from '../../src/constants';
-import { renderClient } from '../../jest/browser-utils';
 
 describe('html attributes', () => {
   describe('API', () => {

__tests__/api/link.test.tsx

@@ -1,8 +1,8 @@
 /** @jest-environment jsdom */
 
+import { renderClient } from '../../jest/browser-utils';
 import { Helmet } from '../../src';
 import { HELMET_ATTRIBUTE } from '../../src/constants';
-import { renderClient } from '../../jest/browser-utils';
 
 describe('link tags', () => {
   describe('API', () => {
@@ -359,10 +359,10 @@ describe('link tags', () => {
             // them is treated as the actual primary attribute. Does not look as
             // a good, intuitive behavior to me... perhaps to be reworked.
             // @ts-expect-error "pre-existing"
-            { rel: 'icon', sizes: '192x192', href: null }, // eslint-disable-line sort-keys
+            { rel: 'icon', sizes: '192x192', href: null }, // eslint-disable-line perfectionist/sort-objects
             {
               rel: 'canonical',
-              href: 'http://localhost/helmet/component', // eslint-disable-line sort-keys
+              href: 'http://localhost/helmet/component', // eslint-disable-line perfectionist/sort-objects
             },
           ]}
         />,
@@ -647,7 +647,7 @@ describe('link tags', () => {
             // them is treated as the actual primary attribute. Does not look as
             // a good, intuitive behavior to me... perhaps to be reworked.
             // @ts-expect-error "pre-existing"
-            href={null} // eslint-disable-line react/jsx-sort-props, @stylistic/jsx-sort-props
+            href={null} // eslint-disable-line perfectionist/sort-jsx-props
           />
           <link href="http://localhost/helmet/component" rel="canonical" />
         </Helmet>,