Halaman ini menjelaskan metode reCAPTCHA Enterprise JavaScript API dan parameter konfigurasinya yang dapat Anda gunakan untuk merender halaman web dengan kunci reCAPTCHA (kunci situs).
Metode reCAPTCHA Enterprise JavaScript API
Bagian ini menjelaskan sintaksis dan parameter metode JavaScript API reCAPTCHA Enterprise.
grecaptcha.enterprise.render
Merender container sebagai widget reCAPTCHA dan menampilkan ID widget yang baru dibuat.
Sintaksis
grecaptcha.enterprise.render(container: string | HTMLelement, parameters: Object): number
Parameter Metode
Parameter | Deskripsi |
---|---|
container | Elemen HTML untuk merender widget reCAPTCHA. Tentukan ID penampung (string) atau elemen DOM itu sendiri. |
parameters |
Objek yang berisi parameter sebagai key=value pair, misalnya,
Lihat Atribut dan parameter untuk mengetahui detail tentang setiap parameter yang dapat dikonfigurasi. |
Nilai yang ditampilkan
Menampilkan ID widget yang baru dibuat.
grecaptcha.enterprise.reset
Mereset widget reCAPTCHA.
Sintaksis
grecaptcha.enterprise.reset(widget_id: number): void
Parameter
Parameter | Deskripsi |
---|---|
widget_id | Opsional. ID widget ditampilkan dari grecaptcha.enterprise.render() . Jika tidak
ditentukan, ID secara default akan ditetapkan ke ID widget pertama yang dibuat.
|
Nilai yang ditampilkan
Tidak menampilkan nilai.
grecaptcha.enterprise.execute
Memanggil verifikasi reCAPTCHA Enterprise secara terprogram.
Sintaksis
grecaptcha.enterprise.execute(widget_id: number): Promise<string>
grecaptcha.enterprise.execute(sitekey: string, action: Object): Promise<string>
Parameter
Parameter | Deskripsi |
---|---|
widget_id | Opsional. ID widget ditampilkan dari grecaptcha.enterprise.render() .
Jika tidak ditentukan, ID secara default akan ditetapkan ke ID widget pertama yang dibuat. |
sitekey |
Menentukan kunci situs reCAPTCHA yang akan dilindungi. |
action | Objek dengan pasangan key=value tunggal, dengan nilai untuk
kunci action menentukan nama tindakan yang terkait dengan
elemen yang dilindungi.
Contoh: |
Nilai yang ditampilkan
Jika berhasil, tampilkan objek Promise yang berisi token jika berhasil.
grecaptcha.enterprise.ready
Menjalankan fungsi Anda saat library JavaScript reCAPTCHA Enterprise dimuat.
Sintaksis
grecaptcha.enterprise.ready(callback: function): void
Parameter
Parameter | Deskripsi |
---|---|
callback | Fungsi yang akan dipanggil saat library reCAPTCHA selesai dimuat. |
Nilai yang ditampilkan
Tidak menampilkan nilai.
grecaptcha.enterprise.getResponse
Mendapatkan respons untuk widget reCAPTCHA.
Sintaksis
grecaptcha.enterprise.getResponse(widget_id: number): string
Parameter
Parameter | Deskripsi |
---|---|
widget_id | Opsional. ID widget ditampilkan dari grecaptcha.enterprise.render() . Jika
tidak ditentukan, ID secara default akan ditetapkan ke ID widget pertama yang dibuat.
|
Nilai yang ditampilkan
Mendapatkan respons widget reCAPTCHA. String ini bisa berupa string dengan token yang dibuat oleh grecaptcha.enterprise.execute()
, atau string kosong jika token belum dibuat.
Konfigurasi
Bagian ini menjelaskan parameter resource JavaScript dan parameter
yang digunakan oleh grecaptcha.enterprise.render()
serta atribut
widget g-recaptcha
.
Parameter resource JavaScript (enterprise.js)
Tabel berikut mencantumkan parameter resource JavaScript (enterprise.js
) yang harus Anda sertakan saat menggunakan reCAPTCHA Enterprise.
Untuk mengetahui informasi lebih lanjut tentang penggunaan parameter ini, lihat contoh di Merender widget reCAPTCHA di frontend.
Parameter | Nilai | Deskripsi |
---|---|---|
onload |
callback | Opsional. Nama fungsi callback yang akan dieksekusi setelah semua dependensi dimuat. |
render
|
onload |
Opsional, nilai default. Merender widget dalam tag |
explicit
|
Opsional. Tidak merender widget secara otomatis. Anda harus memanggil |
|
siteKey |
Jika digunakan dengan kunci situs berbasis skor, parameter ini tidak opsional. Nilai siteKey menentukan kunci situs berbasis skor yang terkait. |
|
hl |
Lihat kode bahasa. | Opsional. Memaksa widget untuk dirender dalam bahasa tertentu. Deteksi otomatis bahasa pengguna jika tidak ditentukan. |
atribut tag g-recaptcha dan parameter grecaptcha.enterprise.render()
Tabel berikut mencantumkan atribut tag g-recaptcha
dan parameter grecaptcha.enterprise.render()
yang sesuai.
Atribut tag g-recaptcha |
Parameter grecaptcha.enterprise.render() |
Nilai yang diizinkan | Default | Deskripsi |
---|---|---|---|---|
data-sitekey |
sitekey |
Kunci reCAPTCHA. | ||
data-badge |
badge |
bottomright , bottomleft , inline
|
bottomright |
Opsional. Mengubah posisi badge reCAPTCHA. inline memungkinkan Anda memosisikannya dengan CSS. |
data-action |
action |
Opsional. String yang menjelaskan tindakan saat ini. | ||
data-theme |
theme |
dark |
light |
Opsional. Tema warna widget. |
data-size |
size |
compact , normal |
normal |
Opsional. Ukuran widget. |
data-tabindex |
tabindex |
Bilangan bulat | 0 | Opsional. Tabindex widget dan tantangan. Jika elemen lain di halaman Anda menggunakan tabindex, elemen tersebut harus disetel untuk mempermudah navigasi pengguna. |
data-callback |
callback |
String | T/A | Opsional. Nama fungsi callback Anda, yang dijalankan saat pengguna
berhasil mengirim respons. Token g-recaptcha-response diteruskan ke callback Anda. |
data-expired-callback |
expired-callback |
String | T/A | Opsional. Nama fungsi callback Anda, yang dieksekusi ketika respons reCAPTCHA habis masa berlakunya dan pengguna harus melakukan verifikasi ulang. |
data-error-callback |
error-callback |
String | T/A | Opsional. Nama fungsi callback Anda, yang dieksekusi ketika reCAPTCHA mengalami error (biasanya konektivitas jaringan) dan tidak dapat dilanjutkan hingga konektivitas pulih. Jika menentukan fungsi di sini, Anda bertanggung jawab untuk memberi tahu pengguna bahwa mereka harus mencoba lagi. |