From b469f42f73e98e2135538a2d948250bbb8242baf Mon Sep 17 00:00:00 2001 From: where where Date: Sat, 14 Mar 2026 17:41:30 +0800 Subject: [PATCH 1/8] Add options for next_vendors --- scripts/helpers/engine.js | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/scripts/helpers/engine.js b/scripts/helpers/engine.js index 6b2f703ac..8d150fa9a 100644 --- a/scripts/helpers/engine.js +++ b/scripts/helpers/engine.js @@ -19,7 +19,9 @@ hexo.extend.helper.register('next_inject', function(point) { hexo.extend.helper.register('next_js', function(file, { pjax = false, - module = false + module = false, + defer = true, + async = false } = {}) { const { next_version } = this; const { internal, custom_cdn_url } = this.theme.vendors; @@ -32,18 +34,21 @@ hexo.extend.helper.register('next_js', function(file, { custom : custom_cdn_url }); const src = links[internal] || links.local; - return ``; + return ``; }); -hexo.extend.helper.register('next_vendors', function(name) { +hexo.extend.helper.register('next_vendors', function(name, { + defer = false, + async = false +} = {}) { const { url, integrity } = this.theme.vendors[name]; const type = url.endsWith('css') ? 'css' : 'js'; if (type === 'css') { if (integrity) return ``; return ``; } - if (integrity) return ``; - return ``; + if (integrity) return ``; + return ``; }); hexo.extend.helper.register('next_data', function(name, ...data) { From 679b07fe5d4b8c6db8a91793592df1f3f965548c Mon Sep 17 00:00:00 2001 From: where where Date: Sat, 14 Mar 2026 17:55:45 +0800 Subject: [PATCH 2/8] Set all defer manually --- layout/_scripts/index.njk | 12 ++++++------ layout/_third-party/addtoany.njk | 2 +- layout/_third-party/chat/chatra.njk | 2 +- layout/_third-party/chat/tidio.njk | 2 +- layout/_third-party/fancybox.njk | 2 +- layout/_third-party/pace.njk | 2 +- layout/_third-party/search/algolia-search.njk | 5 ++--- layout/_third-party/search/localsearch.njk | 4 ++-- layout/_third-party/statistics/firestore.njk | 6 +++--- layout/_third-party/statistics/lean-analytics.njk | 2 +- layout/_third-party/tags/mermaid.njk | 2 +- layout/_third-party/tags/pdf.njk | 2 +- layout/_third-party/tags/wavedrom.njk | 2 +- scripts/helpers/engine.js | 2 +- 14 files changed, 23 insertions(+), 24 deletions(-) diff --git a/layout/_scripts/index.njk b/layout/_scripts/index.njk index 33212bb1b..c98baa72c 100644 --- a/layout/_scripts/index.njk +++ b/layout/_scripts/index.njk @@ -1,22 +1,22 @@ {%- include 'vendors.njk' -%} {%- if theme.injects.comment.length > 1 %} - {{- next_js('comments.js') }} + {{- next_js('comments.js', { defer: true }) }} {%- endif %} {{- next_js('utils.js') }} {%- if theme.motion.enable %} - {{- next_js('motion.js') }} + {{- next_js('motion.js', { defer: true }) }} {%- endif %} {%- if theme.sidebar.display !== 'remove' %} - {{- next_js('sidebar.js') }} + {{- next_js('sidebar.js', { defer: true }) }} {%- endif %} -{{- next_js('next-boot.js') }} +{{- next_js('next-boot.js', { defer: true }) }} {%- if theme.bookmark.enable %} - {{- next_js('bookmark.js') }} + {{- next_js('bookmark.js', { defer: true }) }} {%- endif %} {%- if theme.pjax %} - {{- next_js('pjax.js') }} + {{- next_js('pjax.js', { defer: true }) }} {%- endif %} diff --git a/layout/_third-party/addtoany.njk b/layout/_third-party/addtoany.njk index cbfa521e6..542eff221 100644 --- a/layout/_third-party/addtoany.njk +++ b/layout/_third-party/addtoany.njk @@ -1,3 +1,3 @@ {%- if theme.addtoany.enable %} - {{ next_js('third-party/addtoany.js') }} + {{ next_js('third-party/addtoany.js', { defer: true }) }} {%- endif %} diff --git a/layout/_third-party/chat/chatra.njk b/layout/_third-party/chat/chatra.njk index c0ebd1269..787e3f1be 100644 --- a/layout/_third-party/chat/chatra.njk +++ b/layout/_third-party/chat/chatra.njk @@ -1,3 +1,3 @@ {{ next_data('chatra', theme.chatra) }} -{{ next_js('third-party/chat/chatra.js') }} +{{ next_js('third-party/chat/chatra.js', { defer: true }) }} diff --git a/layout/_third-party/chat/tidio.njk b/layout/_third-party/chat/tidio.njk index 8b222cfdf..cb3505409 100644 --- a/layout/_third-party/chat/tidio.njk +++ b/layout/_third-party/chat/tidio.njk @@ -1,2 +1,2 @@ -{{ next_js('third-party/chat/tidio.js') }} +{{ next_js('third-party/chat/tidio.js', { defer: true }) }} diff --git a/layout/_third-party/fancybox.njk b/layout/_third-party/fancybox.njk index a42c37485..b3e2096f4 100644 --- a/layout/_third-party/fancybox.njk +++ b/layout/_third-party/fancybox.njk @@ -1,3 +1,3 @@ {%- if theme.fancybox %} - {{ next_js('third-party/fancybox.js') }} + {{ next_js('third-party/fancybox.js', { defer: true }) }} {%- endif %} diff --git a/layout/_third-party/pace.njk b/layout/_third-party/pace.njk index ffbadcd46..906605f66 100644 --- a/layout/_third-party/pace.njk +++ b/layout/_third-party/pace.njk @@ -1,3 +1,3 @@ {%- if theme.pace.enable %} - {{ next_js('third-party/pace.js') }} + {{ next_js('third-party/pace.js', { defer: true }) }} {%- endif %} diff --git a/layout/_third-party/search/algolia-search.njk b/layout/_third-party/search/algolia-search.njk index 6ab729ce1..32eaf09d7 100644 --- a/layout/_third-party/search/algolia-search.njk +++ b/layout/_third-party/search/algolia-search.njk @@ -1,3 +1,2 @@ -{{ next_vendors('algolia_search') }} - -{{- next_js('third-party/search/algolia-search.js') }} +{{ next_vendors('algolia_search', { async: true }) }} +{{- next_js('third-party/search/algolia-search.js', { defer: true }) }} diff --git a/layout/_third-party/search/localsearch.njk b/layout/_third-party/search/localsearch.njk index 8a8d52723..7485d33de 100644 --- a/layout/_third-party/search/localsearch.njk +++ b/layout/_third-party/search/localsearch.njk @@ -1,2 +1,2 @@ -{{ next_vendors('local_search') }} -{{ next_js('third-party/search/local-search.js') }} +{{ next_vendors('local_search', { async: true }) }} +{{ next_js('third-party/search/local-search.js', { defer: true }) }} diff --git a/layout/_third-party/statistics/firestore.njk b/layout/_third-party/statistics/firestore.njk index 2bc37a11e..f307d19a4 100644 --- a/layout/_third-party/statistics/firestore.njk +++ b/layout/_third-party/statistics/firestore.njk @@ -1,6 +1,6 @@ {%- if theme.firestore.enable %} - {{ next_vendors('firebase_app') }} - {{ next_vendors('firebase_firestore') }} + {{ next_vendors('firebase_app', { async: true }) }} + {{ next_vendors('firebase_firestore', { async: true }) }} {{ next_data('firestore', theme.firestore) }} - {{ next_js('third-party/statistics/firestore.js') }} + {{ next_js('third-party/statistics/firestore.js', { defer: true }) }} {%- endif %} diff --git a/layout/_third-party/statistics/lean-analytics.njk b/layout/_third-party/statistics/lean-analytics.njk index d3171c47e..d8e3fb23a 100644 --- a/layout/_third-party/statistics/lean-analytics.njk +++ b/layout/_third-party/statistics/lean-analytics.njk @@ -1,4 +1,4 @@ {%- if theme.leancloud_visitors.enable %} {{ next_data('leancloud_visitors', theme.leancloud_visitors) }} - {{ next_js('third-party/statistics/lean-analytics.js') }} + {{ next_js('third-party/statistics/lean-analytics.js', { defer: true }) }} {%- endif %} diff --git a/layout/_third-party/tags/mermaid.njk b/layout/_third-party/tags/mermaid.njk index 1487cb7fb..f83472cfe 100644 --- a/layout/_third-party/tags/mermaid.njk +++ b/layout/_third-party/tags/mermaid.njk @@ -2,5 +2,5 @@ {{ next_data('mermaid', theme.mermaid, { js: theme.vendors.mermaid }) }} - {{ next_js('third-party/tags/mermaid.js') }} + {{ next_js('third-party/tags/mermaid.js', { defer: true }) }} {%- endif %} diff --git a/layout/_third-party/tags/pdf.njk b/layout/_third-party/tags/pdf.njk index d86927cd2..9038b57fe 100644 --- a/layout/_third-party/tags/pdf.njk +++ b/layout/_third-party/tags/pdf.njk @@ -3,5 +3,5 @@ object_url: theme.vendors.pdfobject, url: url_for('lib/pdf/web/viewer.html') }) }} - {{ next_js('third-party/tags/pdf.js') }} + {{ next_js('third-party/tags/pdf.js', { defer: true }) }} {%- endif %} diff --git a/layout/_third-party/tags/wavedrom.njk b/layout/_third-party/tags/wavedrom.njk index 1ff9f4681..058f57afe 100644 --- a/layout/_third-party/tags/wavedrom.njk +++ b/layout/_third-party/tags/wavedrom.njk @@ -5,5 +5,5 @@ {{ next_data('wavedrom_skin', theme.wavedrom, { js: theme.vendors.wavedrom_skin }) }} - {{ next_js('third-party/tags/wavedrom.js') }} + {{ next_js('third-party/tags/wavedrom.js', { defer: true }) }} {%- endif %} diff --git a/scripts/helpers/engine.js b/scripts/helpers/engine.js index 8d150fa9a..a1b5f99df 100644 --- a/scripts/helpers/engine.js +++ b/scripts/helpers/engine.js @@ -20,7 +20,7 @@ hexo.extend.helper.register('next_inject', function(point) { hexo.extend.helper.register('next_js', function(file, { pjax = false, module = false, - defer = true, + defer = false, async = false } = {}) { const { next_version } = this; From d38bdb5abe19067f3cc37cde9d5ab36f2625f5a4 Mon Sep 17 00:00:00 2001 From: where where Date: Sat, 14 Mar 2026 18:52:35 +0800 Subject: [PATCH 3/8] Treat every script load by next_js as user scripts config.js may used by users so treat it as dependence comments.js utils.js motion.js sidebar.js next-boot.js bookmark.js pjax.js should load by order --- layout/_partials/comments.njk | 2 +- layout/_partials/page/schedule.njk | 2 +- layout/_scripts/index.njk | 2 +- layout/_third-party/analytics/baidu-analytics.njk | 2 +- layout/_third-party/analytics/google-analytics.njk | 2 +- layout/_third-party/analytics/growingio.njk | 2 +- layout/_third-party/analytics/matomo.njk | 2 +- layout/_third-party/comments/changyan.njk | 2 +- layout/_third-party/comments/disqus.njk | 2 +- layout/_third-party/comments/disqusjs.njk | 2 +- layout/_third-party/comments/gitalk.njk | 2 +- layout/_third-party/comments/isso.njk | 2 +- layout/_third-party/comments/livere.njk | 2 +- layout/_third-party/comments/utterances.njk | 2 +- layout/_third-party/math/katex.njk | 2 +- layout/_third-party/math/mathjax.njk | 2 +- layout/_third-party/quicklink.njk | 2 +- 17 files changed, 17 insertions(+), 17 deletions(-) diff --git a/layout/_partials/comments.njk b/layout/_partials/comments.njk index b9cf3adc1..44bc8c2d0 100644 --- a/layout/_partials/comments.njk +++ b/layout/_partials/comments.njk @@ -14,7 +14,7 @@ {{ partial(inject_item.layout, inject_item.locals, inject_item.options) }} {%- endfor %} - {{- next_js('comments-buttons.js', { pjax: true }) }} + {{- next_js('comments-buttons.js', { pjax: true, async: true }) }} {%- elif theme.comments.style == 'tabs' %}
    diff --git a/layout/_partials/page/schedule.njk b/layout/_partials/page/schedule.njk index 9deaec163..d97e5ea3b 100644 --- a/layout/_partials/page/schedule.njk +++ b/layout/_partials/page/schedule.njk @@ -1,3 +1,3 @@
    -{{- next_js('schedule.js', { pjax: true }) }} +{{- next_js('schedule.js', { pjax: true, async: true }) }} diff --git a/layout/_scripts/index.njk b/layout/_scripts/index.njk index c98baa72c..7a1a4ec6b 100644 --- a/layout/_scripts/index.njk +++ b/layout/_scripts/index.njk @@ -4,7 +4,7 @@ {{- next_js('comments.js', { defer: true }) }} {%- endif %} -{{- next_js('utils.js') }} +{{- next_js('utils.js', { defer: true }) }} {%- if theme.motion.enable %} {{- next_js('motion.js', { defer: true }) }} {%- endif %} diff --git a/layout/_third-party/analytics/baidu-analytics.njk b/layout/_third-party/analytics/baidu-analytics.njk index 2e1e42926..d7f8db88b 100644 --- a/layout/_third-party/analytics/baidu-analytics.njk +++ b/layout/_third-party/analytics/baidu-analytics.njk @@ -1,4 +1,4 @@ {%- if theme.baidu_analytics %} - {{ next_js('third-party/analytics/baidu-analytics.js') }} + {{ next_js('third-party/analytics/baidu-analytics.js', { async: true }) }} {%- endif %} diff --git a/layout/_third-party/analytics/google-analytics.njk b/layout/_third-party/analytics/google-analytics.njk index b0ffd9c78..816ee3e8b 100644 --- a/layout/_third-party/analytics/google-analytics.njk +++ b/layout/_third-party/analytics/google-analytics.njk @@ -3,5 +3,5 @@ {%- endif %} {{ next_data('google_analytics', theme.google_analytics) }} - {{ next_js('third-party/analytics/google-analytics.js') }} + {{ next_js('third-party/analytics/google-analytics.js', { async: true }) }} {%- endif %} diff --git a/layout/_third-party/analytics/growingio.njk b/layout/_third-party/analytics/growingio.njk index 0c0c496bc..ce105f956 100644 --- a/layout/_third-party/analytics/growingio.njk +++ b/layout/_third-party/analytics/growingio.njk @@ -1,5 +1,5 @@ {%- if theme.growingio_analytics %} {{ next_data('growingio_analytics', theme.growingio_analytics) }} - {{ next_js('third-party/analytics/growingio.js') }} + {{ next_js('third-party/analytics/growingio.js', { async: true }) }} {%- endif %} diff --git a/layout/_third-party/analytics/matomo.njk b/layout/_third-party/analytics/matomo.njk index ed64d1141..fa3909ff7 100644 --- a/layout/_third-party/analytics/matomo.njk +++ b/layout/_third-party/analytics/matomo.njk @@ -1,4 +1,4 @@ {%- if theme.matomo.enable %} {{ next_data('matomo', theme.matomo) }} - {{ next_js('third-party/analytics/matomo.js') }} + {{ next_js('third-party/analytics/matomo.js', { async: true }) }} {%- endif %} diff --git a/layout/_third-party/comments/changyan.njk b/layout/_third-party/comments/changyan.njk index 677c45aaf..b61e7d4b6 100644 --- a/layout/_third-party/comments/changyan.njk +++ b/layout/_third-party/comments/changyan.njk @@ -1,2 +1,2 @@ {{ next_data('changyan', theme.changyan) }} -{{ next_js('third-party/comments/changyan.js') }} +{{ next_js('third-party/comments/changyan.js', { async: true }) }} diff --git a/layout/_third-party/comments/disqus.njk b/layout/_third-party/comments/disqus.njk index 3876f003f..75d80f271 100644 --- a/layout/_third-party/comments/disqus.njk +++ b/layout/_third-party/comments/disqus.njk @@ -3,4 +3,4 @@ disqus: __('disqus') } }) }} -{{ next_js('third-party/comments/disqus.js') }} +{{ next_js('third-party/comments/disqus.js', { async: true }) }} diff --git a/layout/_third-party/comments/disqusjs.njk b/layout/_third-party/comments/disqusjs.njk index d15e2b379..ff495abf0 100644 --- a/layout/_third-party/comments/disqusjs.njk +++ b/layout/_third-party/comments/disqusjs.njk @@ -3,4 +3,4 @@ {{ next_data('disqusjs', theme.disqusjs, { js: theme.vendors.disqusjs_js }) }} -{{ next_js('third-party/comments/disqusjs.js') }} +{{ next_js('third-party/comments/disqusjs.js', { async: true }) }} diff --git a/layout/_third-party/comments/gitalk.njk b/layout/_third-party/comments/gitalk.njk index d1cee1d0a..099a37e28 100644 --- a/layout/_third-party/comments/gitalk.njk +++ b/layout/_third-party/comments/gitalk.njk @@ -4,4 +4,4 @@ js: theme.vendors.gitalk_js, path_md5: gitalk_md5(page.path) }) }} -{{ next_js('third-party/comments/gitalk.js') }} +{{ next_js('third-party/comments/gitalk.js', { async: true }) }} diff --git a/layout/_third-party/comments/isso.njk b/layout/_third-party/comments/isso.njk index 86e86b525..887339376 100644 --- a/layout/_third-party/comments/isso.njk +++ b/layout/_third-party/comments/isso.njk @@ -1,2 +1,2 @@ {{ next_data('isso', theme.isso) }} -{{ next_js('third-party/comments/isso.js') }} +{{ next_js('third-party/comments/isso.js', { async: true }) }} diff --git a/layout/_third-party/comments/livere.njk b/layout/_third-party/comments/livere.njk index 331535b4f..9a0e79863 100644 --- a/layout/_third-party/comments/livere.njk +++ b/layout/_third-party/comments/livere.njk @@ -1 +1 @@ -{{ next_js('third-party/comments/livere.js') }} +{{ next_js('third-party/comments/livere.js', { async: true }) }} diff --git a/layout/_third-party/comments/utterances.njk b/layout/_third-party/comments/utterances.njk index b3656ffcd..fbf4b5b8e 100644 --- a/layout/_third-party/comments/utterances.njk +++ b/layout/_third-party/comments/utterances.njk @@ -1,2 +1,2 @@ {{ next_data('utterances', theme.utterances) }} -{{ next_js('third-party/comments/utterances.js') }} +{{ next_js('third-party/comments/utterances.js', { async: true }) }} diff --git a/layout/_third-party/math/katex.njk b/layout/_third-party/math/katex.njk index 62a64c2c9..0144b766d 100644 --- a/layout/_third-party/math/katex.njk +++ b/layout/_third-party/math/katex.njk @@ -3,5 +3,5 @@ {{ next_data('katex', { copy_tex_js: theme.vendors.copy_tex_js }) }} - {{ next_js('third-party/math/katex.js') }} + {{ next_js('third-party/math/katex.js', { async: true }) }} {%- endif %} diff --git a/layout/_third-party/math/mathjax.njk b/layout/_third-party/math/mathjax.njk index a20bb8beb..afab5b586 100644 --- a/layout/_third-party/math/mathjax.njk +++ b/layout/_third-party/math/mathjax.njk @@ -1,4 +1,4 @@ {{ next_data('mathjax', theme.math.mathjax, { js: theme.vendors.mathjax }) }} -{{ next_js('third-party/math/mathjax.js') }} +{{ next_js('third-party/math/mathjax.js', { async: true }) }} diff --git a/layout/_third-party/quicklink.njk b/layout/_third-party/quicklink.njk index e027a982e..5b4e8cf9e 100644 --- a/layout/_third-party/quicklink.njk +++ b/layout/_third-party/quicklink.njk @@ -3,5 +3,5 @@ {{ next_data('quicklink', page.quicklink, { url: url | replace(r/index\.html$/, '') }) }} - {{ next_js('third-party/quicklink.js') }} + {{ next_js('third-party/quicklink.js', { async: true }) }} {%- endif %} From 712c78db32c2e4e9f7d93da94f5051621df2cfb4 Mon Sep 17 00:00:00 2001 From: where where Date: Sat, 14 Mar 2026 19:03:27 +0800 Subject: [PATCH 4/8] Set the dependences of defer script defer --- layout/_third-party/search/algolia-search.njk | 2 +- layout/_third-party/search/localsearch.njk | 2 +- layout/_third-party/statistics/firestore.njk | 4 ++-- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/layout/_third-party/search/algolia-search.njk b/layout/_third-party/search/algolia-search.njk index 32eaf09d7..71f2a9a38 100644 --- a/layout/_third-party/search/algolia-search.njk +++ b/layout/_third-party/search/algolia-search.njk @@ -1,2 +1,2 @@ -{{ next_vendors('algolia_search', { async: true }) }} +{{ next_vendors('algolia_search', { defer: true }) }} {{- next_js('third-party/search/algolia-search.js', { defer: true }) }} diff --git a/layout/_third-party/search/localsearch.njk b/layout/_third-party/search/localsearch.njk index 7485d33de..b9c3eef7d 100644 --- a/layout/_third-party/search/localsearch.njk +++ b/layout/_third-party/search/localsearch.njk @@ -1,2 +1,2 @@ -{{ next_vendors('local_search', { async: true }) }} +{{ next_vendors('local_search', { defer: true }) }} {{ next_js('third-party/search/local-search.js', { defer: true }) }} diff --git a/layout/_third-party/statistics/firestore.njk b/layout/_third-party/statistics/firestore.njk index f307d19a4..e408a733c 100644 --- a/layout/_third-party/statistics/firestore.njk +++ b/layout/_third-party/statistics/firestore.njk @@ -1,6 +1,6 @@ {%- if theme.firestore.enable %} - {{ next_vendors('firebase_app', { async: true }) }} - {{ next_vendors('firebase_firestore', { async: true }) }} + {{ next_vendors('firebase_app', { defer: true }) }} + {{ next_vendors('firebase_firestore', { defer: true }) }} {{ next_data('firestore', theme.firestore) }} {{ next_js('third-party/statistics/firestore.js', { defer: true }) }} {%- endif %} From 71f51608d89a2bfeee72730777e1aa930279289e Mon Sep 17 00:00:00 2001 From: where where Date: Sat, 14 Mar 2026 19:12:33 +0800 Subject: [PATCH 5/8] Add warn when defer and async both true --- scripts/helpers/engine.js | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/scripts/helpers/engine.js b/scripts/helpers/engine.js index a1b5f99df..92d527c9d 100644 --- a/scripts/helpers/engine.js +++ b/scripts/helpers/engine.js @@ -34,6 +34,9 @@ hexo.extend.helper.register('next_js', function(file, { custom : custom_cdn_url }); const src = links[internal] || links.local; + if (defer && async) { + hexo.log.warn('Both `defer` and `async` are set to true for', file, 'in next_js helper. `defer` will be ignored.'); + } return ``; }); @@ -47,6 +50,9 @@ hexo.extend.helper.register('next_vendors', function(name, { if (integrity) return ``; return ``; } + if (defer && async) { + hexo.log.warn('Both `defer` and `async` are set to true for', name, 'in next_vendors helper. `defer` will be ignored.'); + } if (integrity) return ``; return ``; }); From 18dbb8e5e262170e2784e4e99f04af39ff581002 Mon Sep 17 00:00:00 2001 From: where where Date: Sat, 14 Mar 2026 19:19:04 +0800 Subject: [PATCH 6/8] Set scripts which need page:loaded event to defer --- layout/_third-party/comments/changyan.njk | 2 +- layout/_third-party/comments/disqus.njk | 2 +- layout/_third-party/comments/disqusjs.njk | 2 +- layout/_third-party/comments/gitalk.njk | 2 +- layout/_third-party/comments/isso.njk | 2 +- layout/_third-party/comments/livere.njk | 2 +- layout/_third-party/comments/utterances.njk | 2 +- layout/_third-party/math/katex.njk | 2 +- layout/_third-party/math/mathjax.njk | 2 +- layout/_third-party/quicklink.njk | 2 +- 10 files changed, 10 insertions(+), 10 deletions(-) diff --git a/layout/_third-party/comments/changyan.njk b/layout/_third-party/comments/changyan.njk index b61e7d4b6..81b2bd78a 100644 --- a/layout/_third-party/comments/changyan.njk +++ b/layout/_third-party/comments/changyan.njk @@ -1,2 +1,2 @@ {{ next_data('changyan', theme.changyan) }} -{{ next_js('third-party/comments/changyan.js', { async: true }) }} +{{ next_js('third-party/comments/changyan.js', { defer: true }) }} diff --git a/layout/_third-party/comments/disqus.njk b/layout/_third-party/comments/disqus.njk index 75d80f271..67040a852 100644 --- a/layout/_third-party/comments/disqus.njk +++ b/layout/_third-party/comments/disqus.njk @@ -3,4 +3,4 @@ disqus: __('disqus') } }) }} -{{ next_js('third-party/comments/disqus.js', { async: true }) }} +{{ next_js('third-party/comments/disqus.js', { defer: true }) }} diff --git a/layout/_third-party/comments/disqusjs.njk b/layout/_third-party/comments/disqusjs.njk index ff495abf0..ab531900d 100644 --- a/layout/_third-party/comments/disqusjs.njk +++ b/layout/_third-party/comments/disqusjs.njk @@ -3,4 +3,4 @@ {{ next_data('disqusjs', theme.disqusjs, { js: theme.vendors.disqusjs_js }) }} -{{ next_js('third-party/comments/disqusjs.js', { async: true }) }} +{{ next_js('third-party/comments/disqusjs.js', { defer: true }) }} diff --git a/layout/_third-party/comments/gitalk.njk b/layout/_third-party/comments/gitalk.njk index 099a37e28..c92186752 100644 --- a/layout/_third-party/comments/gitalk.njk +++ b/layout/_third-party/comments/gitalk.njk @@ -4,4 +4,4 @@ js: theme.vendors.gitalk_js, path_md5: gitalk_md5(page.path) }) }} -{{ next_js('third-party/comments/gitalk.js', { async: true }) }} +{{ next_js('third-party/comments/gitalk.js', { defer: true }) }} diff --git a/layout/_third-party/comments/isso.njk b/layout/_third-party/comments/isso.njk index 887339376..c7c34078f 100644 --- a/layout/_third-party/comments/isso.njk +++ b/layout/_third-party/comments/isso.njk @@ -1,2 +1,2 @@ {{ next_data('isso', theme.isso) }} -{{ next_js('third-party/comments/isso.js', { async: true }) }} +{{ next_js('third-party/comments/isso.js', { defer: true }) }} diff --git a/layout/_third-party/comments/livere.njk b/layout/_third-party/comments/livere.njk index 9a0e79863..c575211a0 100644 --- a/layout/_third-party/comments/livere.njk +++ b/layout/_third-party/comments/livere.njk @@ -1 +1 @@ -{{ next_js('third-party/comments/livere.js', { async: true }) }} +{{ next_js('third-party/comments/livere.js', { defer: true }) }} diff --git a/layout/_third-party/comments/utterances.njk b/layout/_third-party/comments/utterances.njk index fbf4b5b8e..3bb676320 100644 --- a/layout/_third-party/comments/utterances.njk +++ b/layout/_third-party/comments/utterances.njk @@ -1,2 +1,2 @@ {{ next_data('utterances', theme.utterances) }} -{{ next_js('third-party/comments/utterances.js', { async: true }) }} +{{ next_js('third-party/comments/utterances.js', { defer: true }) }} diff --git a/layout/_third-party/math/katex.njk b/layout/_third-party/math/katex.njk index 0144b766d..c8452f865 100644 --- a/layout/_third-party/math/katex.njk +++ b/layout/_third-party/math/katex.njk @@ -3,5 +3,5 @@ {{ next_data('katex', { copy_tex_js: theme.vendors.copy_tex_js }) }} - {{ next_js('third-party/math/katex.js', { async: true }) }} + {{ next_js('third-party/math/katex.js', { defer: true }) }} {%- endif %} diff --git a/layout/_third-party/math/mathjax.njk b/layout/_third-party/math/mathjax.njk index afab5b586..4894cda87 100644 --- a/layout/_third-party/math/mathjax.njk +++ b/layout/_third-party/math/mathjax.njk @@ -1,4 +1,4 @@ {{ next_data('mathjax', theme.math.mathjax, { js: theme.vendors.mathjax }) }} -{{ next_js('third-party/math/mathjax.js', { async: true }) }} +{{ next_js('third-party/math/mathjax.js', { defer: true }) }} diff --git a/layout/_third-party/quicklink.njk b/layout/_third-party/quicklink.njk index 5b4e8cf9e..0f4ad6db4 100644 --- a/layout/_third-party/quicklink.njk +++ b/layout/_third-party/quicklink.njk @@ -3,5 +3,5 @@ {{ next_data('quicklink', page.quicklink, { url: url | replace(r/index\.html$/, '') }) }} - {{ next_js('third-party/quicklink.js', { async: true }) }} + {{ next_js('third-party/quicklink.js', { defer: true }) }} {%- endif %} From 9564b7a090e64bb4b62c36117822ffda4d23b440 Mon Sep 17 00:00:00 2001 From: where where Date: Sat, 14 Mar 2026 19:32:49 +0800 Subject: [PATCH 7/8] Set defer to false if async is true --- scripts/helpers/engine.js | 2 ++ 1 file changed, 2 insertions(+) diff --git a/scripts/helpers/engine.js b/scripts/helpers/engine.js index 92d527c9d..65a02f724 100644 --- a/scripts/helpers/engine.js +++ b/scripts/helpers/engine.js @@ -36,6 +36,7 @@ hexo.extend.helper.register('next_js', function(file, { const src = links[internal] || links.local; if (defer && async) { hexo.log.warn('Both `defer` and `async` are set to true for', file, 'in next_js helper. `defer` will be ignored.'); + defer = false; } return ``; }); @@ -52,6 +53,7 @@ hexo.extend.helper.register('next_vendors', function(name, { } if (defer && async) { hexo.log.warn('Both `defer` and `async` are set to true for', name, 'in next_vendors helper. `defer` will be ignored.'); + defer = false; } if (integrity) return ``; return ``; From 76a96719afb977b559261512a22680af43597866 Mon Sep 17 00:00:00 2001 From: where where Date: Sun, 15 Mar 2026 14:54:59 +0800 Subject: [PATCH 8/8] Add defer or async for some next_vendors Set fontawesome to defer since it usually used only as CSS parser Set pace_js to async since this should only set by this theme Set katex to defer since it's document said that Set quicklink to defer since it's document also said that Set pjax to defer since it should only create one instance which it created by this theme Set lazyload to defer since it usually used after DOM is loaded --- layout/_partials/head/head.njk | 4 ++-- layout/_scripts/vendors.njk | 4 ++-- layout/_third-party/math/katex.njk | 2 +- layout/_third-party/quicklink.njk | 2 +- scripts/helpers/next-vendors.js | 17 +++++++++-------- 5 files changed, 15 insertions(+), 14 deletions(-) diff --git a/layout/_partials/head/head.njk b/layout/_partials/head/head.njk index fabf711a0..6fff6c393 100644 --- a/layout/_partials/head/head.njk +++ b/layout/_partials/head/head.njk @@ -48,7 +48,7 @@ {{ next_font() }} -{{ next_vendors('fontawesome') }} +{{ next_vendors('fontawesome', { async: true }) }} {%- if theme.motion.enable %} {{ next_vendors('animate_css') }} @@ -60,7 +60,7 @@ {%- if theme.pace.enable %} {{ next_vendors('pace_css') }} - {{ next_vendors('pace_js') }} + {{ next_vendors('pace_js', { async: true }) }} {%- endif %} {{ next_data('main', next_config()) }} diff --git a/layout/_scripts/vendors.njk b/layout/_scripts/vendors.njk index ed5e147e3..2b415efb9 100644 --- a/layout/_scripts/vendors.njk +++ b/layout/_scripts/vendors.njk @@ -2,6 +2,6 @@ {%- endif %} -{%- for name in js_vendors() %} - {{ next_vendors(name) }} +{%- for name, options in js_vendors() %} + {{ next_vendors(name, options) }} {%- endfor %} diff --git a/layout/_third-party/math/katex.njk b/layout/_third-party/math/katex.njk index c8452f865..064f7a267 100644 --- a/layout/_third-party/math/katex.njk +++ b/layout/_third-party/math/katex.njk @@ -1,4 +1,4 @@ -{{ next_vendors('katex') }} +{{ next_vendors('katex', { defer: true }) }} {%- if theme.math.katex.copy_tex %} {{ next_data('katex', { copy_tex_js: theme.vendors.copy_tex_js diff --git a/layout/_third-party/quicklink.njk b/layout/_third-party/quicklink.njk index 0f4ad6db4..4e2f74943 100644 --- a/layout/_third-party/quicklink.njk +++ b/layout/_third-party/quicklink.njk @@ -1,5 +1,5 @@ {%- if theme.quicklink.enable %} - {{ next_vendors('quicklink') }} + {{ next_vendors('quicklink', { defer: true }) }} {{ next_data('quicklink', page.quicklink, { url: url | replace(r/index\.html$/, '') }) }} diff --git a/scripts/helpers/next-vendors.js b/scripts/helpers/next-vendors.js index 0c0654930..c86277701 100644 --- a/scripts/helpers/next-vendors.js +++ b/scripts/helpers/next-vendors.js @@ -4,27 +4,28 @@ hexo.extend.helper.register('js_vendors', function() { const { config, theme } = this; - const vendors = ['anime']; + const vendors = { anime: {} }; if (theme.prism.enable && !config.prismjs.preprocess) { - vendors.push('prism', 'prism_autoloader'); + vendors.prism = {}; + vendors.prism_autoloader = {}; if (config.prismjs.line_number) { - vendors.push('prism_line_numbers'); + vendors.prism_line_numbers = {}; } } if (theme.pjax) { - vendors.push('pjax'); + vendors.pjax = { defer: true }; } if (theme.fancybox) { - vendors.push('fancybox_js'); + vendors.fancybox_js = {}; } if (theme.mediumzoom) { - vendors.push('mediumzoom'); + vendors.mediumzoom = {}; } if (theme.lazyload) { - vendors.push('lazyload'); + vendors.lazyload = { defer: true }; } if (theme.pangu) { - vendors.push('pangu'); + vendors.pangu = {}; } return vendors; });