Pengantar
Banyak proyek di web yang memerlukan antarmuka dengan REST API di beberapa tahapan pengembangannya. Axios adalah klien HTTP ringan yang berdasarkan layanan $http
dalam Angular.js v1.x dan mirip dengan Fetch API JavaScript asli.
Axios berbasis janji, yang memberi Anda kemampuan untuk memanfaatkan
async
dan await
dari JavaScript agar kode yang tidak sinkron lebih mudah dibaca.
Anda juga dapat mencegat dan membatalkan permintaan, dan ada perlindungan bawaan di sisi klien terhadap pemalsuan permintaan lintas situs.
Dalam artikel ini, Anda akan mendalami contoh cara menggunakan Axios untuk mengakses JSON Placeholder API yang populer di dalam aplikasi React.
Prasyarat
Untuk mengikuti artikel ini, Anda akan membutuhkan hal berikut:
- Node.js versi 10.16.0 yang terinstal di komputer Anda. Untuk menginstalnya di macOS atau Ubuntu 18.04, ikuti langkah-langkah dalam Cara Menginstal Node.js dan Membuat Lingkungan Pengembangan Lokal di macOS, atau bagian Menginstal Menggunakan PPA pada Cara Menginstal Node.js di Ubuntu 18.04.
- Proyek React baru yang telah disiapkan dengan Create React App yang mengikuti tutorial Cara Menyiapkan Proyek React dengan Create React App.
- Ini juga akan membantu mendapatkan pemahaman dasar tentang JavaScript, yang dapat Anda temukan dalam seri Cara Menulis Kode di JavaScript, bersama pengetahuan dasar HTML dan CSS.
Langkah 1 — Menambahkan Axios ke Proyek
Di bagian ini, Anda akan menambahkan Axios ke proyek React digital-ocean-tutorial
yang telah Anda buat dengan mengikuti tutorial Cara Menyiapkan Proyek React dengan Create React App.
Untuk menambahkan Axios ke proyek, buka terminal dan ubah direktori ke proyek Anda:
- cd digital-ocean-tutorial
Kemudian, jalankan perintah ini untuk menginstal Axios:
- npm install axios
Selanjutnya, Anda perlu mengimpor Axios ke dalam berkas tempat Anda ingin menggunakannya.
Langkah 2 — Membuat Permintaan GET
Dalam contoh ini, Anda membuat komponen baru dan mengimpor Axios ke dalamnya untuk mengirimkan permintaan GET
.
Di dalam folder src
dari proyek React, buat komponen baru bernama PersonList.js
:
- nano src/PersonList.js
Tambahkan kode berikut ke komponen:
digital-ocean-tutorial/src/PersonList.js
import React from 'react';
import axios from 'axios';
export default class PersonList extends React.Component {
state = {
persons: []
}
componentDidMount[] {
axios.get[`//jsonplaceholder.typicode.com/users`]
.then[res => {
const persons = res.data;
this.setState[{ persons }];
}]
}
render[] {
return [
{ this.state.persons.map[person => {person.name}]}
]
}
}
Pertama, Anda mengimpor React dan Axios agar keduanya dapat digunakan dalam komponen. Kemudian, Anda kaitkan ke kait siklus hidup componentDidMount
dan membuat permintaan GET
.
Anda menggunakan axios.get[url]
dengan URL dari titik akhir API untuk mendapatkan janji yang akan mengembalikan objek respons. Di dalam objek respons, ada data yang nanti memberikan nilai person
.
Anda juga bisa mendapatkan informasi lainnya tentang
permintaan, seperti kode status pada res.status
atau informasi lainnya di dalam res.request
.
Langkah 3 — Membuat Permintaan POST
Dalam langkah ini, Anda akan menggunakan Axios bersama metode permintaan HTTP lainnya bernama POST
.
Hapus kode sebelumnya di PersonList
dan tambahkan yang berikut untuk membuat suatu bentuk yang memungkinkan masukan pengguna dan selanjutnya melakukan POST
konten ke API:
digital-ocean-tutorial/src/PersonList.js
import React from 'react';
import axios from 'axios';
export default class PersonList extends React.Component {
state = {
name: '',
}
handleChange = event => {
this.setState[{ name: event.target.value }];
}
handleSubmit = event => {
event.preventDefault[];
const user = {
name: this.state.name
};
axios.post[`//jsonplaceholder.typicode.com/users`, { user }]
.then[res => {
console.log[res];
console.log[res.data];
}]
}
render[] {
return [
Person Name:
Add
]
}
}
Di dalam fungsi handleSubmit
, Anda mencegah tindakan asali formulir tersebut. Kemudian, perbarui state
ke masukan user
.
Penggunaan POST
memberi Anda objek respons yang sama dengan informasi yang dapat Anda gunakan di dalam panggilan then
.
Untuk menyelesaikan permintaan POST
, tangkap dahulu masukan user
. Kemudian, tambahkan masukan bersama permintaan POST
, yang akan memberi Anda respons. Anda nanti dapat melakukan console.log
respons tersebut, yang
akan menampilkan masukan user
di formulir.
Langkah 4 — Membuat Permintaan DELETE
Dalam contoh ini, Anda akan melihat cara menghapus item dari API menggunakan axios.delete
dan meneruskan URL sebagai parameter.
Ubah kode untuk formulir dari contoh POST
untuk menghapus pengguna sebagai ganti menambahkan yang baru:
digital-ocean-tutorial/src/PersonList.js
import React from 'react';
import axios from 'axios';
export default class PersonList extends React.Component {
state = {
id: '',
}
handleChange = event => {
this.setState[{ id: event.target.value }];
}
handleSubmit = event => {
event.preventDefault[];
axios.delete[`//jsonplaceholder.typicode.com/users/${this.state.id}`]
.then[res => {
console.log[res];
console.log[res.data];
}]
}
render[] {
return [
Person ID:
Delete
]
}
}
Sekali lagi, objek res
memberi Anda informasi tentang
permintaan. Anda nanti dapat melakukan console.log
informasi itu lagi setelah formulir dikirimkan.
Langkah 5 — Menggunakan Instans Dasar di Axios
Dalam contoh ini, Anda akan melihat cara menyiapkan _instans dasa_r tempat Anda mendefinisikan URL dan elemen konfigurasi lainnya.
Buat berkas terpisah bernama api.js
:
- nano src/api.js
Ekspor instans axios
yang baru dengan asali ini:
digital-ocean-tutorial/src/api.js
import axios from 'axios';
export default axios.create[{
baseURL: `//jsonplaceholder.typicode.com/`
}];
Setelah instans asali disiapkan, itu nanti dapat digunakan di dalam komponen PersonList
. Anda mengimpor instans baru seperti ini:
digital-ocean-tutorial/src/PersonList.js
import React from 'react';
import axios from 'axios';
import API from '../api';
export default class PersonList extends React.Component {
handleSubmit = event => {
event.preventDefault[];
API.delete[`users/${this.state.id}`]
.then[res => {
console.log[res];
console.log[res.data];
}]
}
}
Karena //jsonplaceholder.typicode.com/
kini merupakan URL basis, Anda tidak perlu lagi mengetikkan URL selengkapnya setiap kali ingin mencapai titik akhir yang berbeda di API.
Langkah 6 — Menggunakan async
dan await
Dalam contoh ini, Anda akan melihat cara menggunakan
async
dan await
untuk menangani janji.
Kata kunci await
menentukan promise
dan mengembalikan value
. Value
tersebut nanti dapat diberikan ke variabel.
handleSubmit = async event => {
event.preventDefault[];
//
const response = await API.delete[`users/${this.state.id}`];
console.log[response];
console.log[response.data];
};
Dalam contoh kode ini, .then[]
telah diganti. promise
telah diputuskan dan nilainya disimpan di dalam variabel response
.
Kesimpulan
Dalam tutorial ini, Anda telah mendalami beberapa contoh tentang cara menggunakan Axios di dalam aplikasi React untuk membuat permintaan HTTP dan menangani respons.
Jika Anda ingin mempelajari lebih lanjut tentang React, lihat seri Cara Menulis Kode di React.js, atau lihat laman topik React untuk latihan dan proyek pemrograman lainnya.