Fetch is now asynchronous. You can pass a callback to fetch and fetch will pass the response to your callback.

Author: instanceofMA

examples/esp32/async/get/get.ino

@@ -0,0 +1,63 @@
+#include "recipes/WiFi.h"
+#include "Fetch.h"
+
+#define SSID YourWiFiSSID
+#define PASSPHRASE YourWiFiPassphrase
+// Certificate will expire and might need to be updated before running this sketch.
+#define CACert "-----BEGIN CERTIFICATE-----\n\
+MIIDxTCCAq2gAwIBAgIQAqxcJmoLQJuPC3nyrkYldzANBgkqhkiG9w0BAQUFADBs\n\
+MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3\n\
+d3cuZGlnaWNlcnQuY29tMSswKQYDVQQDEyJEaWdpQ2VydCBIaWdoIEFzc3VyYW5j\n\
+ZSBFViBSb290IENBMB4XDTA2MTExMDAwMDAwMFoXDTMxMTExMDAwMDAwMFowbDEL\n\
+MAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3\n\
+LmRpZ2ljZXJ0LmNvbTErMCkGA1UEAxMiRGlnaUNlcnQgSGlnaCBBc3N1cmFuY2Ug\n\
+RVYgUm9vdCBDQTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMbM5XPm\n\
++9S75S0tMqbf5YE/yc0lSbZxKsPVlDRnogocsF9ppkCxxLeyj9CYpKlBWTrT3JTW\n\
+PNt0OKRKzE0lgvdKpVMSOO7zSW1xkX5jtqumX8OkhPhPYlG++MXs2ziS4wblCJEM\n\
+xChBVfvLWokVfnHoNb9Ncgk9vjo4UFt3MRuNs8ckRZqnrG0AFFoEt7oT61EKmEFB\n\
+Ik5lYYeBQVCmeVyJ3hlKV9Uu5l0cUyx+mM0aBhakaHPQNAQTXKFx01p8VdteZOE3\n\
+hzBWBOURtCmAEvF5OYiiAhF8J2a3iLd48soKqDirCmTCv2ZdlYTBoSUeh10aUAsg\n\
+EsxBu24LUTi4S8sCAwEAAaNjMGEwDgYDVR0PAQH/BAQDAgGGMA8GA1UdEwEB/wQF\n\
+MAMBAf8wHQYDVR0OBBYEFLE+w2kD+L9HAdSYJhoIAu9jZCvDMB8GA1UdIwQYMBaA\n\
+FLE+w2kD+L9HAdSYJhoIAu9jZCvDMA0GCSqGSIb3DQEBBQUAA4IBAQAcGgaX3Nec\n\
+nzyIZgYIVyHbIUf4KmeqvxgydkAQV8GK83rZEWWONfqe/EW1ntlMMUu4kehDLI6z\n\
+eM7b41N5cdblIZQB2lWHmiRk9opmzN6cN82oNLFpmyPInngiK3BD41VHMWEZ71jF\n\
+hS9OMPagMRYjyOfiZRYzy78aG6A9+MpeizGLYAiJLQwGXFK3xPkKmNEVX58Svnw2\n\
+Yzi9RKR/5CYrCsSXaQ3pjOLAEFe4yHYSkVXySGnYvCoCWw9E1CAx2/S6cCZdkGCe\n\
+vEsXCS+0yx5DaMkHJ8HSXPfqIbloEpw8nL+e/IBcm2PN7EeqJSdnoDfzAIJ9VNep\n\
++OkuE6N36B9K\n\
+-----END CERTIFICATE-----"
+
+// Fetch when used in async mode returns a client that listens for the response.
+FetchClient client;
+
+// Function that handles the response when it's received.
+void handleResponse(Response response) {
+    Serial.println("Response received:");
+    // Printing response body as plain text.
+    Serial.println();
+    Serial.println(response.text());
+}
+
+void setup() {
+    Serial.begin(9600);
+    connectWiFi(SSID, PASSPHRASE);
+
+    RequestOptions options;
+    options.method = "GET";
+    options.caCert = CACert;
+    
+    Serial.println("Sending the request...");
+
+    // Fetch sends the response, when received, to our handleResponse function, instead of blocking the rest of the code until the response is received.
+    
+    client = fetch("https://api.github.com/", options, handleResponse);
+
+    Serial.println("Request Sent!");
+    Serial.println("Waiting for the response...");
+}
+
+void loop() {
+    // This is crucial, it listens on the connection for the response, until it's received.
+    client.loop();
+}

examples/esp32/get/recipes/Blink.h renamed to examples/esp32/async/get/recipes/Blink.h

@@ -0,0 +1,74 @@
+#include "recipes/WiFi.h"
+#include "Fetch.h"
+
+#define SSID YourWiFiSSID
+#define PASSPHRASE YourWiFiPassphrase
+// Certificate will expire and might need to be updated before running this sketch.
+#define CACert "-----BEGIN CERTIFICATE-----\n\
+MIIFazCCA1OgAwIBAgIRAIIQz7DSQONZRGPgu2OCiwAwDQYJKoZIhvcNAQELBQAw\n\
+TzELMAkGA1UEBhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2Vh\n\
+cmNoIEdyb3VwMRUwEwYDVQQDEwxJU1JHIFJvb3QgWDEwHhcNMTUwNjA0MTEwNDM4\n\
+WhcNMzUwNjA0MTEwNDM4WjBPMQswCQYDVQQGEwJVUzEpMCcGA1UEChMgSW50ZXJu\n\
+ZXQgU2VjdXJpdHkgUmVzZWFyY2ggR3JvdXAxFTATBgNVBAMTDElTUkcgUm9vdCBY\n\
+MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK3oJHP0FDfzm54rVygc\n\
+h77ct984kIxuPOZXoHj3dcKi/vVqbvYATyjb3miGbESTtrFj/RQSa78f0uoxmyF+\n\
+0TM8ukj13Xnfs7j/EvEhmkvBioZxaUpmZmyPfjxwv60pIgbz5MDmgK7iS4+3mX6U\n\
+A5/TR5d8mUgjU+g4rk8Kb4Mu0UlXjIB0ttov0DiNewNwIRt18jA8+o+u3dpjq+sW\n\
+T8KOEUt+zwvo/7V3LvSye0rgTBIlDHCNAymg4VMk7BPZ7hm/ELNKjD+Jo2FR3qyH\n\
+B5T0Y3HsLuJvW5iB4YlcNHlsdu87kGJ55tukmi8mxdAQ4Q7e2RCOFvu396j3x+UC\n\
+B5iPNgiV5+I3lg02dZ77DnKxHZu8A/lJBdiB3QW0KtZB6awBdpUKD9jf1b0SHzUv\n\
+KBds0pjBqAlkd25HN7rOrFleaJ1/ctaJxQZBKT5ZPt0m9STJEadao0xAH0ahmbWn\n\
+OlFuhjuefXKnEgV4We0+UXgVCwOPjdAvBbI+e0ocS3MFEvzG6uBQE3xDk3SzynTn\n\
+jh8BCNAw1FtxNrQHusEwMFxIt4I7mKZ9YIqioymCzLq9gwQbooMDQaHWBfEbwrbw\n\
+qHyGO0aoSCqI3Haadr8faqU9GY/rOPNk3sgrDQoo//fb4hVC1CLQJ13hef4Y53CI\n\
+rU7m2Ys6xt0nUW7/vGT1M0NPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV\n\
+HRMBAf8EBTADAQH/MB0GA1UdDgQWBBR5tFnme7bl5AFzgAiIyBpY9umbbjANBgkq\n\
+hkiG9w0BAQsFAAOCAgEAVR9YqbyyqFDQDLHYGmkgJykIrGF1XIpu+ILlaS/V9lZL\n\
+ubhzEFnTIZd+50xx+7LSYK05qAvqFyFWhfFQDlnrzuBZ6brJFe+GnY+EgPbk6ZGQ\n\
+3BebYhtF8GaV0nxvwuo77x/Py9auJ/GpsMiu/X1+mvoiBOv/2X/qkSsisRcOj/KK\n\
+NFtY2PwByVS5uCbMiogziUwthDyC3+6WVwW6LLv3xLfHTjuCvjHIInNzktHCgKQ5\n\
+ORAzI4JMPJ+GslWYHb4phowim57iaztXOoJwTdwJx4nLCgdNbOhdjsnvzqvHu7Ur\n\
+TkXWStAmzOVyyghqpZXjFaH3pO3JLF+l+/+sKAIuvtd7u+Nxe5AW0wdeRlN8NwdC\n\
+jNPElpzVmbUq4JUagEiuTDkHzsxHpFKVK7q4+63SM1N95R1NbdWhscdCb+ZAJzVc\n\
+oyi3B43njTOQ5yOf+1CceWxG1bQVs5ZufpsMljq4Ui0/1lvh+wjChP4kqKOJ2qxq\n\
+4RgqsahDYVvTH9w7jXbyLeiNdd8XM2w9U/t7y0Ff/9yi0GE44Za4rF2LN9d11TPA\n\
+mRGunUHBcnWEvgJBQl9nJEiU0Zsnvgc/ubhPgXRR4Xq37Z0j4r7g1SgEEzwxA57d\n\
+emyPxgcYxn/eR44/KJ4EBs+lVDR3veyJm+kXQ99b21/+jh5Xos1AnX5iItreGCc=\n\
+-----END CERTIFICATE-----"
+
+// Fetch when used in async mode returns a client that listens for the response.
+FetchClient client;
+
+// Function that handles the response when it's received.
+void handleResponse(Response response) {
+    Serial.println("Response received:");
+    // Printing response.
+    Serial.println(response);
+    // Printing respons headers.
+    Serial.printf("Connection Header: \"%s\"\n", response.headers["Content-Type"].c_str());
+    Serial.printf("Connection Header: \"%s\"\n", response.headers["Connection"].c_str());
+}
+
+void setup() {
+    Serial.begin(9600);
+    connectWiFi(SSID, PASSPHRASE);
+
+    RequestOptions options;
+    options.method = "POST";
+    options.headers["Content-Type"] = "application/json";
+    options.body = "{\"email\": \"[email protected]\", \"password\": \"test:80\"}";
+    options.caCert = CACert;
+    
+    Serial.println("Sending the request...");
+
+    // Fetch sends the response, when received, to our handleResponse function, instead of blocking the rest of the code until the response is received.
+    client = fetch("https://api.grandeur.tech/auth/login/?apiKey=grandeurkywxmoy914080rxf9dh05n7e", options, handleResponse);
+
+    Serial.println("Request Sent!");
+    Serial.println("Waiting for the response...");
+}
+
+void loop() {
+    // This is crucial, it listens on the connection for the response, until it's received.
+    client.loop();
+}

examples/esp32/get/recipes/WiFi.h renamed to examples/esp32/async/get/recipes/WiFi.h

@@ -3,6 +3,7 @@
 
 #define SSID YourWiFiSSID
 #define PASSPHRASE YourWiFiPassphrase
+// Certificate will expire and might need to be updated before running this sketch.
 #define CACert "-----BEGIN CERTIFICATE-----\n\
 MIIDxTCCAq2gAwIBAgIQAqxcJmoLQJuPC3nyrkYldzANBgkqhkiG9w0BAQUFADBs\n\
 MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3\n\

examples/esp32/async/post/post.ino

@@ -0,0 +1,94 @@
+#include <Arduino.h>
+
+#ifndef BLINK_H
+#define BLINK_H
+
+#define LEDPIN 2
+#define OFF 1
+#define ON 0
+
+// Makes the LED blink once every 1 second.
+void blinkOnce() {
+    pinMode(LEDPIN, OUTPUT);
+    // Turning ON.
+    digitalWrite(LEDPIN, ON);
+    delay(1000);
+    // Turning OFF.
+    digitalWrite(LEDPIN, OFF);
+    delay(1000);
+}
+
+// Makes the LED blink twice every 1 second.
+void blinkTwice() {
+    pinMode(LEDPIN, OUTPUT);
+    // Turning ON.
+    digitalWrite(LEDPIN, ON);
+    delay(500);
+    // Turning OFF.
+    digitalWrite(LEDPIN, OFF);
+    delay(500);
+}
+
+// Makes the LED blink n-times every 1 second.
+void blinkN(size_t n) {
+    pinMode(LEDPIN, OUTPUT);
+    // Turning ON.
+    digitalWrite(LEDPIN, ON);
+    delay(1000/n);
+    // Turning OFF.
+    digitalWrite(LEDPIN, OFF);
+    delay(1000/n);
+}
+
+// Makes the LED stop blinking.
+void blinkStop() {
+    pinMode(LEDPIN, OUTPUT);
+    digitalWrite(LEDPIN, OFF);
+}
+
+// Makes the LED fade in and out once every 1 second.
+void fadeOnce() {
+    pinMode(LEDPIN, OUTPUT);
+    // Fading in.
+    for(int i = 0; i < 1024; i+=1024/20) {
+        analogWrite(LEDPIN, i);
+        delay(100);
+    }
+    // Fading out.
+    for(int i = 1023; i > 0; i-=1024/20) {
+        analogWrite(LEDPIN, i);
+        delay(100);
+    }
+}
+
+// Makes the LED fade in and out twice every 1 second.
+void fadeTwice() {
+    pinMode(LEDPIN, OUTPUT);
+    // Fading in.
+    for(int i = 0; i < 1024; i+=1024/20) {
+        analogWrite(LEDPIN, i);
+        delay(50);
+    }
+    // Fading out.
+    for(int i = 1023; i > 0; i-=1024/20) {
+        analogWrite(LEDPIN, i);
+        delay(50);
+    }
+}
+
+// Makes the LED fade in and out n-times every 1 second.
+void fadeN(size_t n) {
+    pinMode(LEDPIN, OUTPUT);
+    // Fading in.
+    for(int i = 0; i < 1024; i+=1024/20) {
+        analogWrite(LEDPIN, i);
+        delay(100/n);
+    }
+    // Fading out.
+    for(int i = 1023; i > 0; i-=1024/20) {
+        analogWrite(LEDPIN, i);
+        delay(100/n);
+    }
+}
+
+#endif /* BLINK_H */

examples/esp32/post/recipes/Blink.h renamed to examples/esp32/async/post/recipes/Blink.h

@@ -0,0 +1,34 @@
+#ifndef WIFI_H
+#define WIFI_H
+
+#include <Arduino.h>
+#include <WiFi.h>
+// #include "blink.h"
+
+// Makes the device connect to a WiFi router or hotspot.
+void connectWiFi(const char* ssid, const char* passphrase) {
+    // Disconnecting WiFi if it"s already connected.
+    WiFi.disconnect();
+    // Setting it to Station mode which basically scans for nearby WiFi routers or hotspots.
+    WiFi.mode(WIFI_STA);
+    // Begin connecting to WiFi using the provided ssid and passphrase.
+    WiFi.begin(ssid, passphrase);
+    // Print a debug log to Serial.
+    Serial.printf("\nDevice is connecting to WiFi using SSID %s and Passphrase %s.\n", ssid, passphrase);
+    // Keep looping until the WiFi is not connected.
+    while (WiFi.status() != WL_CONNECTED) {
+        // Print dots in a horizontal line to the Serial, showing the WiFi is trying to connect.
+        Serial.print(".");
+        delay(1000);
+        // Blink LED very fast, showing the WiFi is trying to connect.
+        // blinkN(10);
+    }
+    // Stop the LED blinking, showing the WiFi is successfully connected.
+    // blinkStop();
+    // Print debug logs to Serial.
+    Serial.println("WiFi connected");
+    Serial.print("IP Address: ");
+    Serial.println(WiFi.localIP()); // Local IP Address of the ESP8266 device.
+}
+
+#endif /* WIFI_H */

examples/esp32/post/recipes/WiFi.h renamed to examples/esp32/async/post/recipes/WiFi.h

@@ -3,6 +3,7 @@
 
 #define SSID YourWiFiSSID
 #define PASSPHRASE YourWiFiPassphrase
+// Certificate will expire and might need to be updated before running this sketch.
 #define CACert "-----BEGIN CERTIFICATE-----\n\
 MIIFazCCA1OgAwIBAgIRAIIQz7DSQONZRGPgu2OCiwAwDQYJKoZIhvcNAQELBQAw\n\
 TzELMAkGA1UEBhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2Vh\n\

examples/esp32/get/get.ino renamed to examples/esp32/sync/get/get.ino

@@ -0,0 +1,34 @@
+#ifndef WIFI_H
+#define WIFI_H
+
+#include <Arduino.h>
+#include <WiFi.h>
+// #include "blink.h"
+
+// Makes the device connect to a WiFi router or hotspot.
+void connectWiFi(const char* ssid, const char* passphrase) {
+    // Disconnecting WiFi if it"s already connected.
+    WiFi.disconnect();
+    // Setting it to Station mode which basically scans for nearby WiFi routers or hotspots.
+    WiFi.mode(WIFI_STA);
+    // Begin connecting to WiFi using the provided ssid and passphrase.
+    WiFi.begin(ssid, passphrase);
+    // Print a debug log to Serial.
+    Serial.printf("\nDevice is connecting to WiFi using SSID %s and Passphrase %s.\n", ssid, passphrase);
+    // Keep looping until the WiFi is not connected.
+    while (WiFi.status() != WL_CONNECTED) {
+        // Print dots in a horizontal line to the Serial, showing the WiFi is trying to connect.
+        Serial.print(".");
+        // Blink LED very fast, showing the WiFi is trying to connect.
+        delay(1000);
+        // blinkN(10);
+    }
+    // Stop the LED blinking, showing the WiFi is successfully connected.
+    // blinkStop();
+    // Print debug logs to Serial.
+    Serial.println("WiFi connected");
+    Serial.print("IP Address: ");
+    Serial.println(WiFi.localIP()); // Local IP Address of the ESP8266 device.
+}
+
+#endif /* WIFI_H */

examples/esp32/sync/get/recipes/Blink.h

@@ -0,0 +1,40 @@
+#include "recipes/WiFi.h"
+#include "Fetch.h"
+
+#define SSID YourWiFiSSID
+#define PASSPHRASE YourWiFiPassphrase
+// Fingerprint will expire and might need to be updated before running this sketch.
+#define FINGERPRINT "29 70 30 74 CA 3C 48 F5 4A 79 C6 2D 11 57 A2 41 2A 2D 7D 5C"
+
+// Fetch when used in async mode returns a client that listens for the response.
+FetchClient client;
+
+// Function that handles the response when it's received.
+void handleResponse(Response response) {
+    Serial.println("Response received:");
+    // Printing response body as plain text.
+    Serial.println();
+    Serial.println(response.text());
+}
+
+void setup() {
+    Serial.begin(9600);
+    connectWiFi(SSID, PASSPHRASE);
+
+    RequestOptions options;
+    options.method = "GET";
+    options.fingerprint = FINGERPRINT;
+    
+    Serial.println("Sending the request...");
+
+    // Fetch sends the response, when received, to our handleResponse function, instead of blocking the rest of the code until the response is received.
+    client = fetch("https://api.github.com/", options, handleResponse);
+
+    Serial.println("Request Sent!");
+    Serial.println("Waiting for the response...");
+}
+
+void loop() {
+    // This is crucial, it listens on the connection for the response, until it's received.
+    client.loop();
+}