Sys-front-inj-javascript Role¶
Description: No description available
Variables¶
author: Kevin Veen-Birkenbach
description: Injects a custom JavaScript snippet into Nginx-served HTML responses via sub_filter.
company: Kevin Veen-Birkenbach
Consulting & Coaching Solutions https://www.veen.world
license: Infinito.Nexus NonCommercial License
license_url: https://s.infinito.nexus/license
min_ansible_version: 2.9
platforms: [{‘name’: ‘Archlinux’, ‘versions’: [‘rolling’]}]
galaxy_tags: [‘nginx’, ‘javascript’, ‘csp’, ‘sub_filter’, ‘injection’, ‘global’]
repository: https://s.infinito.nexus/code
documentation: https://docs.infinito.nexus
issue_tracker_url: https://s.infinito.nexus/issues
README¶
🌐 Global JavaScript Injector for Nginx¶
Description¶
This Ansible role injects a custom JavaScript snippet into all HTML
responses served by Nginx. It leverages Nginx’s sub_filter to
seamlessly insert your application-specific script just before the
closing </head> tag, ensuring that your code runs on every page
load—perfect for global feature flags, analytics, or UI enhancements.
Features¶
- One-line Script InjectionCollapses your JavaScript into a single line and injects it via
sub_filterfor minimal footprint and maximal compatibility. - Easy CSP IntegrationAutomatically computes and appends a CSP hash entry for your script, so you can lock down Content Security Policy without lifting a finger.
- Conditional ActivationActivates only when you enable the
javascriptfeature for a given application, keeping your server blocks clean and performant. - Debug ModeSupports an
MODE_DEBUGflag that appends optionalconsole.logstatements for easier troubleshooting in staging or development.