Dog Image Search

This is a front-end project built with Node.js and the Koa web framework, allowing users to search for dog images by breed or retrieve random dog images.

Features

1. Search by Breed: Users can input a specific dog breed to retrieve an image corresponding to that breed.
2. Random Dog Image: Users can obtain a random dog picture.
3. Testing: Includes test files for random dog picture retrieval.

Getting Started

Prerequisites

• Node.js installed on your machine.

Installation

1. Clone the repository:

   git clone https://github.com/Yiqing-Gu/Dog-Image-Search.git

2. Navigate to the project directory:

   cd Dog-Image-Search

3. Install the dependencies:

   npm install

Usage

1. Start the server:

   node main.js

2. If the server starts successfully, the terminal will display:

   Server running on http://localhost:3011
   

3. Open your web browser and navigate to http://localhost:3011.
4. Use the interface to search for a specific dog breed or get a random dog image.

Testing

This project uses Jest and SuperTest for testing.

Setup Tests

1. Install the testing dependencies:

   npm install -D jest supertest

2. Ensure your package.json includes the following under "scripts":

   "scripts": {
     "test": "jest --watchAll"
   }

3. To run the tests:

   npm run test

4. The console will display the test results, including status codes and URLs for random images.

Acknowledgements

• Dog API for providing the dog images.
• Jest and SuperTest for testing frameworks.