JavaScript Integration

Integrate SilentShield into any website using vanilla JavaScript, or use our framework-specific guides for React, Vue, and Angular.

1. Add the Script Tag

Add this script tag to your HTML, ideally before the closing </body> tag:

<script src="https://api.silentshield.io/client.js?key=YOUR_API_KEY" defer></script>

2. Initialize the Widget

Call SilentShield.init() after the DOM is loaded:

document.addEventListener('DOMContentLoaded', function() {
  SilentShield.init({
    apiKey: 'YOUR_API_KEY',
    lang: 'auto',
    features: {
      telemetry: true,
      captchaUI: true,
      fallbackCaptcha: true,
      showBrandingBadge: true,
    },
    onVerdict: function(response) {
      console.log('SilentShield verdict:', response);
    }
  });
});

Configuration Options

apiKey

API key (required)

lang

Language code or 'auto' for browser detection (default: 'auto'). Supports 25 languages.

thresholdSuspicious

Score below this triggers a challenge (default: 0.6)

thresholdBlock

Score below this blocks the request (default: 0.3)

telemetry

Enable behavior tracking (default: true)

captchaUI

Show CAPTCHA UI when needed (default: true)

fallbackCaptcha

Enable math CAPTCHA fallback (default: true)

showBrandingBadge

Show 'Protected by SilentShield' badge (default: true)

zeroPii

Disable browser fingerprinting for maximum privacy (default: false). See Features → Zero-PII Mode.

debugOverlay

Show debug overlay (default: false)

onVerdict

Callback function called when a verdict is received

Reading the Nonce

After form submission, the nonce is available as a hidden field:

const nonce = document.querySelector('input[name="ss_nonce"]')?.value;