<p>Creating a server-side web API with Javascript or Typescript means solving two objectives with one single action. You don't have to learn other backend programming languages like C#, Python, etc. to create a web application.</p>
<p>Deno is a secure runtime environment for Javascript and Typescript where you can run your Javascript/Typescript code. To create REST API we are going to use a Deno middleware web framework called Oak.</p>
<h2>What is Middleware in Deno?</h2>
<p>Middleware makes web development easier for developers so they can focus on the specific purpose of their applications. For example, the Oak framework was created for Deno's Http server where a client can send a request to a server and get a response from the server.</p>
<p>Let's say you want to upload files on google drive or somewhere on the internet and you clicked the upload button after selecting files. By pressing that button you send a request to the web-server and when it says "Your files uploaded successfully" or something like that, that is the response from the web server.</p>
<p>You will understand much better when you will create the REST API.</p>
<h2>Prerequisites</h2>
<p>To follow this post, you should have basic knowledge of <a href="https://www.typescriptlang.org/">Typescript</a>.</p>
<p>Also, I recommend you to learn <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Messages">HTTP Messages</a> like Http request, response, etc. That way you can understand how data is being exchanged between a server and client.</p>
<h2>Getting Started</h2>
<p>If you haven't installed Deno on your computer, check out the <a href="https://alhaqi.com/blog/install-deno-on-windows-mac-linux-operating-systems">Deno Installation on Windows, Mac, and Linux Operating Systems</a> article.</p>
<p>I am going to use the most popular text editor <strong>VS Code</strong> for this project. You have to install the Deno official plugin to work with the Deno project otherwise it will give you some errors. I recommend you to read the <a href="https://alhaqi.com/blog/deno-intellisense-on-vscode">Deno IntelliSense on VS Code</a> article to setup your Vs Code for Deno.</p>
<p>In any case, If you are stuck at following this post, you can check the completed code in this <a href="https://github.com/MejanH/web-api-deno">github repository</a>.</p>
<h2>Building backend web API with Deno</h2>
<p>Create a folder and open it on the VS Code and enable Deno extension on the project folder by creating <code>.vscode/settings.json</code>.</p>
<p>Now, create a <code>server.ts</code> file on the project directory and paste the code from below.</p>
<pre><code class="language-typescript">import { Application } from "https://deno.land/x/oak/mod.ts";

const app = new Application();

app.use((context) => {
  context.response.body = "Hello World!";
});

await app.listen({ port: 8000 });
</code></pre>
<p>In this code above, we exported the <code>Application</code> from the Deno Oak module. If you visit the link that class imported from, you will see the export statement of the <code>Application</code> class there.</p>
<p>Then we created a new instance of the <code>Application</code> using the <code>new</code> operator which creates a new object with <code>Application</code> shape and runs the constructor to initialize it. Read the <a href="https://www.typescriptlang.org/docs/handbook/classes.html">Classes in Typescript</a> documentation to understand with more examples.</p>
<p>The <code>Application</code> has two methods called <code>.use()</code> and <code>.listen()</code>. The <code>.use()</code> method register the middlware and the <code>.listen()</code> method first start the server then start processing requests with the registered middleware.</p>
<p>If you look at the code, first we registered the middleware by using <code>app.use()</code> method then we used <code>app.listen()</code> method to start the server and process the requests from the middleware.</p>
<p>In the <code>.use()</code> method we passed an object called <code>context</code>. Now, What is <code>context</code> in the Oak middleware framework? The <code>context</code> provides information about the current state of the application. For example, We are sending an Http response message(<code>Hello World!</code>) to the client via <code>context</code>.</p>
<h2>Why is there no <code>async</code> keyword before <code>await</code> in Deno?</h2>
<p>You might notice that there is an <code>await</code> keyword before <code>.listen()</code> method but no function starts with the <code>async</code> keyword. So, does <code>await</code> work without <code>async</code> function in Deno? Yes, because Deno supports <a href="https://github.com/tc39/proposal-top-level-await">Top-level <code>await</code></a> feature but that does not mean you can use <code>await</code> in everywhere without <code>async</code> functions. Let me explain in more detail.</p>
<h4>What is the Top-level <code>await</code> feature in Deno?</h4>
<p>Top-level <code>await</code> enables the capability to use the <code>await</code> keyword outside of async functions which act like big async functions. But you can't use the <code>await</code> keyword in regular functions without the <code>async</code> keyword like the code below.</p>
<pre><code class="language-javascript">function something(){
    // you have to add async before the function
    await wrong()
}
</code></pre>
<p>Top-level <code>await</code> only works at the top level of modules like the <code>await</code> before <code>.listen()</code> method above. So, it will wait until the Promises of <code>app.listen()</code> are resolved.</p>
<h2>Starting the API</h2>
<p>As you saw there is a value we passed called <code>port</code> in the <code>listen()</code> method. So, What is <code>port</code> in the <code>.listen()</code> method? It's a unique port of your local testing server which will start by the <code>.listen()</code> method. But why inside curly braces? Because we are Destructuring. We are passing an object as a function parameter.</p>
<p>Let's start the server to understand more.</p>
<p>Save the file, open the terminal on your VS Code and run:</p>
<pre><code class="language-bash">deno run --allow-net server.ts
</code></pre>
<p><code>--allow-net</code> grant the permission to access the network. In Deno, you need to explicitly permit programs to do certain actions, such as access to the network.</p>
<p>Now, open your browser and visit <code>http://localhost:8000/</code>. You will get the <code>Hello World!</code> message in your browser.</p>
<h3>What is localhost in Deno?</h3>
<p>Localhost means your local computer where your server or program is running on. Developers run their programs on the localhost to test their applications working or not.</p>
<p>And, Ports are used to be able to run multiple servers so you can work with other application servers without closing your existing server. You can try other numbers as port too like <code>5000</code>, <code>3000</code> etc.</p>
<p>So, This is how you create a REST API with Deno and run it. But how can you test it? How can you send a request to the server or get the response from the server? Let's see how to do that.</p>
<h2>How to test your web API?</h2>
<p>There are a lot of tools to test web API. I am going to use the most popular and simple app called Insomnia Core.</p>
<p>Download and install the <a href="https://insomnia.rest/">Insomnia Core</a> on your computer then open it.</p>
<p>To create a new request click on the <strong>plus icon</strong> from the left side then click <strong>New Request</strong>. It will Popup a window to name your Request. Name whatever you want to name, I am naming it <strong>Default</strong> for now. Click <strong>Create</strong> to create your request.</p>
<p><img src="/images/insomnia-creating-requests.png" alt="Creating New Request With Insomnia"></p>
<p><img src="/images/naming-request-insomnia.png" alt="Naming Requests Insomnia"></p>
<p>Now, Paste your localhost URL(<code>http://localhost:8000</code>) on the URL bar of insomnia. There is a dropdown menu on the left side of the URL bar. Click on the menu to see all the available Http request methods like <code>GET</code>, <code>POST</code>, etc. Based on our source code, we are retrieving data from the server so we will select the <strong><code>GET</code></strong> method.</p>
<p>Finally, click on the <strong>Send</strong> button to send the <code>GET</code> request to the server. You will see the <code>Hello World!</code> message will appear on the right side.</p>
<p><img src="/images/sending-requests-insomnia.png" alt="Sending Requests Insomnia"></p>
<h2>Passing an array from Deno server to client</h2>
<p>Let's say we want to send a list of blog posts to the client. So, we should have an array of every blog post where the blog posts will be in JSON Objects format.</p>
<p>So, let's create an array and pass it on <code>context</code> in the <code>.use()</code> method like the code below. Also, write a <code>console.log()</code> message to display server information on your terminal.</p>
<pre><code class="language-typescript">import { Application } from "https://deno.land/x/oak/mod.ts";

const app = new Application();

const posts = [
  {
    id: 1,
    title:
      "sunt aut facere repellat provident occaecati excepturi optio reprehenderit",
    body:
      "quia et suscipit\nsuscipit recusandae consequuntur expedita et cum\nreprehenderit molestiae ut ut quas totam\nnostrum rerum est autem sunt rem eveniet architecto",
  },
  {
    id: 2,
    title: "qui est esse",
    body:
      "est rerum tempore vitae\nsequi sint nihil reprehenderit dolor beatae ea dolores neque\nfugiat blanditiis voluptate porro vel nihil molestiae ut reiciendis\nqui aperiam non debitis possimus qui neque nisi nulla",
  },
  {
    id: 3,
    title: "ea molestias quasi exercitationem repellat qui ipsa sit aut",
    body:
      "et iusto sed quo iure\nvoluptatem occaecati omnis eligendi aut ad\nvoluptatem doloribus vel accusantium quis pariatur\nmolestiae porro eius odio et labore et velit aut",
  },
  {
    id: 4,
    title: "eum et est occaecati",
    body:
      "ullam et saepe reiciendis voluptatem adipisci\nsit amet autem assumenda provident rerum culpa\nquis hic commodi nesciunt rem tenetur doloremque ipsam iure\nquis sunt voluptatem rerum illo velit",
  },
];

app.use((context) => {
  context.response.body = posts;
});

app.listen({ port: 8000 });

console.log("Server running on http://localhost:8000");
</code></pre>
<p>Save the file, press <code>Ctrl+C</code> on your terminal to close the current running server. Because every time you change your code you need to restart the server to see changes. Now, run the <code>deno run --allow-net server.ts</code> command again to restart the server.</p>
<p>Go to insomnia and click the send button again. The posts data should appear on the right side like the screenshot below.</p>
<p><img src="/images/terminal-message-of-deno-server.png" alt="colsole message of server runniing"></p>
<p><img src="/images/get-resuest-for-array-insomnia.jpg" alt="array of posts in insomnia"></p>
<p>That's it, now you have learned how you can create, run, and test your web API with Deno.</p>
<h2>Conclusion</h2>
<p>In this whole post, I talked about only the <code>GET</code> request method which was basic of a REST API. You should make your next goal to create a crud API with Deno if you want to learn more.</p>
<p>If you don't understand any part of this post make sure to comment below. Also, If you learn something good from here don't forget to share the link to others.</p>

Nav-Tree

#oak

Create a REST API With Deno Oak Framework

No More Posts Available...