enngage

ngx-captcha

[![npm version](https://badge.fury.io/js/ngx-captcha.svg)](https://badge.fury.io/js/ngx-captcha)

[![Build Status](https://api.travis-ci.org/Enngage/ngx-captcha.svg?branch=master)](https://travis-ci.org/Enngage/ngx-captcha)

[![NPM](https://nodei.co/npm/ngx-captcha.png?mini=true)](https://nodei.co/npm/ngx-captcha/)

Google reCaptcha implementation for Angular 13.

Google reCaptcha implementation for Angular 14.

Live examples: [https://enngage.github.io/ngx-captcha/](https://enngage.github.io/ngx-captcha/)

Import `NgxCaptchaModule ` to your module (i.e. `AppModule`)

Depending on whether you want to use [reactive forms](https://angular.io/guide/reactive-forms) or [template-driven forms](https://angular.io/guide/forms) you need to include the appropriate modules, too.

Add `ReactiveFormsModule` to your imports in case you want to use reactive forms. If you prefer the the template-driven approach simple add the `FormsModule` to your module. 

Both can be imported from `@angular/forms`. In the demo project you can check out the *normal* demo to see how to use reactive forms or the *invisible* demo to see what the template-driven approach looks like. With the template-driven approach you don't necessarily need to use a from element to wrap the component, you can instead use the `[ngModelOptions]="{ standalone: true }"`.

However, using it with the standalone option is not recommended but can be used if needed. 

import { NgModule } from '@angular/core';

import { ReactiveFormsModule } from '@angular/forms';

import { NgxCaptchaModule } from 'ngx-captcha';

The configuration properties are a copy of the official ones that google provides. For explanation of what these properties do and how to use them, please refer to [https://developers.google.com/recaptcha/docs/display](https://developers.google.com/recaptcha/docs/display) and [https://developers.google.com/recaptcha/docs/invisible](https://developers.google.com/recaptcha/docs/invisible).

export class YourComponent implements OnInit {

  constructor(private formBuilder: FormBuilder) {}

    this.aFormGroup = this.formBuilder.group({

      recaptcha: ['', Validators.required]

This is the implementation of beta version of google reCaptcha v3 as per following documentation["https://developers.google.com/recaptcha/docs/v3"](https://developers.google.com/recaptcha/docs/v3).

First you need to inject the class in your component / service and then use Execute method with your action. Once you have the token, you need to verify it on your backend to get meaningful results. See official google documentation for more details.

 import { ReCaptchaV3Service } from 'ngx-captcha';

    private reCaptchaV3Service: ReCaptchaV3Service

  this.reCaptchaV3Service.execute(this.siteKey, 'homepage', (token) => {

    console.log('This is your token: ', token);

    [ngModelOptions]="{ standalone: true }">

Unit testing in Angular is possible, but a bit clunky because this component tries to dynamically include google's script if its not already loaded. You are not required to include in globally or manually which has a benefit of not loading until you actually use this component. This has a caveat though, since the `load` callback is executed outside of Angular's zone, performing unit tests might fail due to racing condition where Angular might fail the test before the script has a chance to load and initialize captcha. 

A simple fix for this is wait certain amount of time so that everything has a chance to initialize. See example below:

        fixture = TestBed.createComponent(YourComponent);

        component = fixture.componentInstance;

Other possible scenario might be including google's script globally. If someone has a better solution, please do let me know or submit a PR for a change in readme.

    "url": "https://github.com/Enngage/ngx-captcha"

  "description": "Dynamic captcha (Google reCaptcha) implementation for Angular",

    "@angular/common": "^13.0.0 | ^14.0.0",

    "@angular/common": "^13.0.0 || ^14.0.0",

    "@angular/core": "^13.0.0 || ^14.0.0"

  "fesm2020": "fesm2020/ngx-captcha.mjs",

  "fesm2015": "fesm2015/ngx-captcha.mjs",

      "esm2020": "./esm2020/ngx-captcha.mjs",

      "es2020": "./fesm2020/ngx-captcha.mjs",

      "es2015": "./fesm2015/ngx-captcha.mjs",

      "node": "./fesm2015/ngx-captcha.mjs",

      "default": "./fesm2020/ngx-captcha.mjs"

		@@ -7,3 +7,3 @@ [![npm version](https://badge.fury.io/js/ngx-captcha.svg)](https://badge.fury.io/js/ngx-captcha)

		Google reCaptcha implementation for Angular 13.
		Google reCaptcha implementation for Angular 14.

		@@ -78,6 +78,2 @@ Features:
		[useGlobalDomain]="false"
		[size]="size"
		[hl]="lang"
		[theme]="theme"
		[type]="type"
		formControlName="recaptcha">
		@@ -120,5 +116,2 @@ </ngx-recaptcha2>
		(success)="handleSuccess($event)"
		[useGlobalDomain]="false"
		[type]="type"
		[badge]="badge"
		[ngModel]="recaptcha"
		@@ -125,0 +118,0 @@ [ngModelOptions]="{ standalone: true }">

		{
		"name": "ngx-captcha",
		"version": "12.0.1",
		"version": "12.0.2",
		"license": "MIT",
		@@ -24,4 +24,4 @@ "repository": {
		"peerDependencies": {
		"@angular/common": "^13.0.0 \| ^14.0.0",
		"@angular/core": "^13.0.0 \| ^14.0.0"
		"@angular/common": "^13.0.0 \|\| ^14.0.0",
		"@angular/core": "^13.0.0 \|\| ^14.0.0"
		},
		@@ -28,0 +28,0 @@ "module": "fesm2015/ngx-captcha.mjs",

Improved metrics