View the full changelog.

View the full changelog.

View the full changelog.

Welcome to this new release of Mockoon. There are several bug fixes and new features in this version that we hope you will like.

We also started working on the GraphQL mocking. As we want to deliver the right feature, we would be glad to gather more feedback on what you expect. Feel free to reach us on our Discord server, or comment on the issue.

Our sponsor

Mockoon is an open-source project built by volunteer maintainers. If you like our application, please consider sponsoring us and join all the Sponsors and Backers who helped this project over time!

CLI

[BREAKING CHANGE] We removed the support for Node.js 12 as it is not maintained anymore. (Issue #702)

Environment files change monitoring

After temporarily disabling the new environment files watcher in v1.18.1 due to an issue, we reworked this feature from the ground up. It must now be manually activated in the settings and offers more choices:

You can now activate the file watcher and reload the environments after validating a confirmation prompt, or automatically.

Issue #649.

Improved default route response selection

Defining the default response is now easier. Before this change, the default response was always the first one. Now, the blue flag indicates the default response and you can change it by clicking on the grey flags:

Issue #252.

New templating helpers and Faker.js update

We added new templating helpers: lowercase, uppercase, and base64Decode. (Issues #655 and #625)

We also updated Faker.js to version 6. It offers some new helpers and locales. (Issue #716)

Copy an endpoint full path

A new context menu entry is available to copy the full API endpoint path:

Issue #633.

Google Analytics removal

Following the introduction of a custom privacy-friendly telemetry system last year, we removed Google Analytics from the desktop application. (Issue #713)

Fixes

• The API prefix is now correctly removed when forwarding (using the proxy mode) to a prefixed endpoint. (Issue #585)
• Logs are now properly displayed even when Mockoon is called with malformed URIs. (Issue #689)
• The setVar helper is now correctly working inside block helpers. (Issue #706)
• The faker helper now returns the correct value and not only strings. It makes this helper compatible with other helpers that requires numbers, arrays or booleans to work (e.g. int, if, each, etc.). (Issue #699)

Misc

We moved the project to a monorepo to accelerate the development and reduce the amount of manipulation we have to do when working on features. (Issue #640) We also updated the CI workflows to always test the packaged desktop application when opening PRs. It will greatly reduce the amount of testing needed during a release.

Docs

We updated the OpenAPI documentation to explain the discrepancies between the specification and Mockoon's features.

Thank you

A big thank you to the following people that helped to make Mockoon better:

• @barefootdeveloper: Improved default route response selection. (Issue #252)
• @tsgodara: Logs crashing when malformed URI sent. (Issue #689)

Welcome to this new release of Mockoon. There are several bug fixes and new features in this version that we hope you will like.

Mockoon is an open-source project built by volunteer maintainers. If you like our application, please consider sponsoring us and join all the Sponsors and Backers who helped this project over time!

Patch v1.18.1

We temporarily disabled v1.18.0's automated file changes monitoring (see below) due do some unforeseen bugs (Issue #649). We will investigate and fix the issue in the next release.

Environment files changes monitoring

Mockoon now monitors for environment's files external changes and automatically reloads the interface with the new data. It's completely automated and will restart the running server if needed. (Issue #580)

Import/export deprecation

We removed the options to import/export your mock data in Mockoon's proprietary format. Since v1.16.0, importing and exporting in Mockoon's format was made mostly useless. Environment files are now easier to share "as-is" and they are supported out of the box by the CLI. Also, user feedback indicated that keeping this export option was rather confusing.

Here are the consequences of this removal:

• import/export in Mockoon's format options were removed.
• Exporting environments and routes to the clipboard (in the right-click context menu) now copy the regular JSON data, without wrapping them in the old export format.

The application and the CLI are still able to open old export files, but you won't be able to create them anymore.

(Issue #626)

Mock API samples

To help you mock third party APIs in no time, we added more than 2000 new mock samples: 1Password, AWS, Giphy Mastercard, Slack, etc. You can run them directly in the application or the CLI:

➡️Head over to our website to discover all the Mock Samples!

Many thanks to the awesome folks at APIs.guru who maintains this list of public APIs!

Enhancements

• Mockoon now directly streams files that do not support templating, or when templating is disabled, to improve the performance, especially the memory usage. (Issue #605)
• The query string display in the logs has been improved. It now shows the raw query and the parameters in a more structured way: (Issue #635)

Fixes

• dateTimeShift helper's days, months, years, etc. parameters are now compatible with helpers returning strings (queryParam, etc.). (Issue mockoon/commons-server#39)
• Using bodyRaw without a path is now compatible with other helpers like each and allows to retrieve root level arrays. (Issue mockoon/commons-server#41)
• Using numbers as body and bodyRaw paths, like in {{#repeat 2}}{{body @index}}{{/repeat}}, now works and returns the correct values. (Issue mockoon/commons-server#42)
• AppImage format should now correctly show the application icon in the dock.

Thank you

A big thank you to the following people that helped to make Mockoon better:

• @timon: Improved query string display in logs. (Issue #635)

Welcome to this new release of Mockoon. There are several bug fixes and new features in this version that we hope you will like.

Mockoon is an open-source project built by volunteer maintainers. If you like our application, please consider sponsoring us and join all the Sponsors and Backers who helped this project over time!

Environment files changes monitoring

Mockoon now monitors for environment's files external changes and automatically reloads the interface with the new data. It's completely automated and will restart the running server if needed. (Issue #580)

Import/export deprecation

We removed the options to import/export your mock data in Mockoon's proprietary format. Since v1.16.0, importing and exporting in Mockoon's format was made mostly useless. Environment files are now easier to share "as-is" and they are supported out of the box by the CLI. Also, user feedback indicated that keeping this export option was rather confusing.

Here are the consequences of this removal:

• import/export in Mockoon's format options were removed.
• Exporting environments and routes to the clipboard (in the right-click context menu) now copy the regular JSON data, without wrapping them in the old export format.

The application and the CLI are still able to open old export files, but you won't be able to create them anymore.

(Issue #626)

Mock API samples

To help you mock third party APIs in no time, we added more than 2000 new mock samples: 1Password, AWS, Giphy Mastercard, Slack, etc. You can run them directly in the application or the CLI:

➡️Head over to our website to discover all the Mock Samples!

Many thanks to the awesome folks at APIs.guru who maintains this list of public APIs!

Enhancements

• Mockoon now directly streams files that do not support templating, or when templating is disabled, to improve the performance, especially the memory usage. (Issue #605)
• The query string display in the logs has been improved. It now shows the raw query and the parameters in a more structured way: (Issue #635)

Fixes

• dateTimeShift helper's days, months, years, etc. parameters are now compatible with helpers returning strings (queryParam, etc.). (Issue mockoon/commons-server#39)
• Using bodyRaw without a path is now compatible with other helpers like each and allows to retrieve root level arrays. (Issue mockoon/commons-server#41)
• Using numbers as body and bodyRaw paths, like in {{#repeat 2}}{{body @index}}{{/repeat}}, now works and returns the correct values. (Issue mockoon/commons-server#42)
• AppImage format should now correctly show the application icon in the dock.

Thank you

A big thank you to the following people that helped to make Mockoon better:

• @timon: Improved query string display in logs. (Issue #635)

Welcome to this new release of Mockoon. There are several bug fixes and new features in this version that we hope you will like.

UI redesign

To improve some features' discoverability and declutter the interface a bit, we redesigned the main header. We also polished the interface a bit here and there. Here are the most significant changes:

(Issue #509)

New header design

We transformed the main header into a new menu with tabs to make the proxy mode and logs more easily discoverable. We also split the environment settings into three new sections: the environment headers, the proxy options, and the environment settings.

The environment's information previously available in the header are now in the "Settings" tab. You can edit the environment's name in both the "Settings" page and the environment menu (see below).

Environment's menu improvements

We made small adjustments to the environment menu:

• You can edit the environment's name directly in the menu.

• We removed the "CORS" icon as the option is always enabled and moved the "HTTPS" icon next to the URL.

• The "Truncate long paths" option in the application settings (ctrl+comma) also applies now to the environment menu. If enabled, environment URLs won't be truncated anymore.

  

Headers and rules "click-to-confirm" delete button

Headers and rules lists now uses a click-to-confirm delete button:

Responses list improvements

The route responses menu is now split into two lines as it was becoming too cluttered.

File and body information display improvements

We reorganized the "Status & body" tab. More precisely, we removed the redundant Content-Type information and replaced it with a small "footer" under the body editor. This footer will always display the effective Content-Type taking the order of precedence into account: environment headers → file mime type → route headers

Ability to provide custom TLS certificate

You can now provide a custom TLS certificate to serve your mocks over HTTPS. Mockoon still uses the same self-signed certificate as before if you don't provide a custom one.

(Issue #175)

New response rules for cookies

A new response rule is available to check a cookie's value or presence:

(Issue #475)

New templating helpers

• New Handlebar helpers are available: join, len, gt, lt, gte, lte, eq, toFixed, round, stringify, slice. Head over to the helpers documentation to learn how to use them. (Issues mockoon/commons-server#29, mockoon/commons-server#31, mockoon/commons-server#32)

Misc

• When creating a new environment, the default name won't be "New environment" anymore but will be taken from the chosen environment's file name. (Issue #598)
• Cookie domains are now removed when forwarded with the proxy mode. (Issue #245)

Bug fixes

• Fixed setVar helper which could not handle Object, 0 or Arrays. (Issue mockoon/commons-server#33)
• Fixed switch/case helpers which wouldn't work properly with number. (Issue mockoon/commons-server#37)
• We switched from using a (heavy) icons font to using inline SVG to solve the icons flickering issue when loading the application. (Issue #509)

Thank you

A big thank you to the following people that helped to make Mockoon better:

• @gamedevtutorials: Response rules for cookies, and all the new templating helpers.
• @Saucistophe: Cookie domain removal in proxy mode.

Welcome to this new release of Mockoon. There are several bug fixes and new features in this version that we hope you will like.

New storage system

The main feature of this release is the new storage system that allows for more flexibility and easier API sharing. The new system works more or less like any other file editor. It stores environments separately and lets you close and open them from anywhere on your hard drive. So, what exactly happened during this update? Mockoon split Your existing data file located in the application data folder into as many files as you had environments. These files were created in the same storage folder with incremental names: environment-0.json, environment-1.json, etc.

You can now move these files anywhere on your hard drive and open them from there.

Multiple benefits from this change:

• you can now more easily share your environments with your coworkers by saving them in a Git-tracked folder. There is no need to import/export every time there is a change anymore.
• we added an environment schema validation to ensure that the environment you load is valid and does not break the application behavior.

You can find out more about this feature in our blog post.

Body files relative path resolving

Mockoon will now try to resolve your body files relatively to the environment's file location. It allows you to store body files alongside the environment file and share them with your coworkers without having relative or absolute path issues.

(Issue #531)

New buttons and menu entries

Following the new storage change, we added several new buttons and options to allow you to manage your environment files.

• You can create a new environment or open an existing one using the two buttons at the top of the environment menu:

  

• You can now close one environment using the context menu:

  

• There is a new context menu entry you can use to locate the environment file on your computer:

  

Most of the actions tied to the environments also changed. You will now get prompted to choose a folder location for your new environment every time you create, duplicate, or import.

New mock samples

We added more API samples to help you start working in no time. You can find them on our website. Starting with this version (1.16.0), you can load them directly in Mockoon by clicking on the "Open" buttons on the page.

(issue #551)

Environment menu redesign

We reverted last year's change that made the environments' menu collapsible. This menu was only showing the first two letters of the environment's name. We listened to your feedback, and we decided to revert this change and go back to a resizable menu. We tried to keep it as compact as possible, considering that most users have no more than one or two environments. Let us know what you think!

(Issue #386)

XML support

Response rules and body templating helper now support XML in entering requests. See the documentation for more information.

(Issue #208)

New rules operators

Two new rules operators, "null" and "empty array", were added to allow you to check against null values and empty arrays in bodies, query params, etc.

(Issue #255)

Route filtering shortcuts

We added some keyboard shortcuts to the route filtering: Cmd or Ctrl + Shift + F to focus, Esc to clear the field. (Issue #451)

Thank you

A big thank you to the following people that helped to make Mockoon better:

• @gamedevtutorials: Response rules null and empty array operators. (Issue #255)

Welcome to this new release of Mockoon. There are several bug fixes and new features in this version that we hope you will like.

Windows portable version

Mockoon is now available as a portable version for Windows. You can download it from our website. When running the portable version, a data folder will automatically be created next to the executable. It contains Mockoon's application files and your settings and environments in ./mockoon-data/storage/environments|settings.json (these files are usually stored in c:/Users/xxx/AppData/Roaming/mockoon/storage for the non-portable application):

Localhost only

You can now set up your mocks to listen to localhost only instead of all network adapters (0.0.0.0). This feature is also supported by the CLI's latest release to a greater extent as you can provide any hostname at runtime mockoon-cli ... --hostname 192.168.x.x. (Issue #469)

Preview compressed body in logs

Compressed bodies (gzip, brotli and deflate) from proxied APIs are now automatically decompressed to be able to read the body content in the logs. (Issue #479)

Rules reordering

Rules can now be reordered with a simple drag and drop. Check our documentation about rules order interpretation. (Issue #456)

New templating helpers

• We added some new math helpers: add, subtract, multiply, divide, modulo, ceil, floor. See the documentation for more information on how to use them. (Issue #499)

• Two new helpers, bodyRaw and queryParamRaw, are available. They allow you to fetch part of the entering body or query parameters "as-is" (nothing will be stringified) and use the result (arrays, objects, etc.) in Handlebars' {{#each}} or {{#if}} helpers. See the documentation for more information. The body and queryParam helpers remain untouched. (Issue mockoon/commons-server#18)

• A new split helper allows you to split string and use the resulting array in Handlebars' {{#each}} helpers. See the documentation for more information. (Issue mockoon/commons-server#22)

404 fallback

A new route response option has been added to automatically send a 404 status when a file was not found. It also reverts to the body present in the editor. (Issue #473)

Improvements:

• You can now tune the number of logs entries in the settings. (Issue #267)

  

• We added a new and privacy friendly way to collect basic usage information (a.k.a. "telemetry"). This will collect a minimal amount of information anonymously. You can read more about this topic in our FAQ. We plan to remove Google Analytics completely in a near future. (Issue #518)

Fixes:

• The header helper does not return an error message anymore when no name is provided. (Issue mockoon/commons-server#14)

• The dateTimeShift helper is now compatible with other helpers like queryParam for the date parameter: {{dateTimeShift date=(queryParam 'date') ...}}. (Issue mockoon/commons-server#15)

• When duplicating a route to an unnamed environment, the hostname, port, and prefix has been added to the modal dialog. (Issue #532)

Developer things

• Electron's main process code is now built with Webpack to make code splitting easier. (Issue #495)
• We updated Angular to v12 and Electron to v13. (Issue #524)

Thank you

A big thank you to the following people that helped to make Mockoon better:

• @barefootdeveloper: Server listening to localhost only, configurable number of log entries. (Issue #469 and #267)
• @louiealmeda: File not found 404 fallback. (Issue #473)

V1.14.1 Changelog

This patch addresses the following issue:

• Allowing duplicated headers (issue #318) was causing some issues with the pre-flight OPTIONS calls and breaking the route headers precedence over environment headers. Duplicated headers are now limited to the Set-Cookie header. (Issue #480)

V1.14.0 Changelog

Welcome to this new release of Mockoon. There are several bug fixes and new features in this version that we hope you will like. But first some news:

• With this release, we decided to take the CLI out of beta 🎉. There is still space for improvements, but it looks stable enough. One breaking change though: Node.js v10 is not supported anymore.

• More users are joining Mockoon's community every day, spreading the word, contributing to the codebase, and giving us invaluable feedback. We are grateful for this. ❤ While we dedicate more and more time to this project, we are looking for sponsors to help us pursue this great endeavor.

• We are interested to learn about specific use cases you or your company encountered. It could even become an article, like Impala's API UX research process we recently published. Contact us!

And now the changelog:

Features:

Custom status codes (Issue #199)

We added some missing status codes to the dropdown, but more importantly, you can now enter custom status codes. Even very invalid ones like 999.

Sequential responses (Issue #459)

A new option is now available to serve different responses sequentially. In the below example, Mockoon will answer with 200 → 404 → 500 → 200 → 404... and so on. The sequence gets reset after restarting the server.

Head over to the sequential responses documentation to learn more about this feature.

Request number response rule (Issue #459)

A new type of rule, "Request number", is now available. It allows you to serve a specific response depending on the index (number) of the entering requests. As for the sequential responses feature, it gets reset when restarting the server.

This example returns a 500 error only for the first call:

While this one returns a 500 error for the first 9 calls:

Head over to the response rules documentation to learn more about this feature.

Misc

• A new baseUrl helper has been added which returns the request's base URL (without the route path): {protocol}://{hostname}:{port}/{prefix}. (Issue mockoon/commons-server#7)

• A new option has been added to prevent forwarding of the API prefix when the proxy mode is enabled. (Issue #237)

  

Improvements:

• To improve the application stability, only one instance can run at a single time. Running a second instance of the application will focus the running instance if any. (Issue #455)

• Multiple headers with the same name are now supported everywhere (route headers, environment headers, proxy request/response headers). This may be a non-standard way of sending the headers (vs comma-separated values) but a common one, especially for the Set-Cookie header. (Issue #318)

• We added more suggestions to the header names and values dropdowns to help you mock faster!

• Thanks to work on issue #199, we improved the look and feel of the HTTP methods dropdown with improved hype (and more accessible) pastel colors.

  

• "Port is invalid" message has been updated to "Port is invalid or access is denied" to give more hints about the potentially reserved ports on Windows. (Issue #463)

Fixes:

• We updated the Faker.js library to its latest version. This indirectly solved the issue with 'internet.avatar' URLs returning a 403. (Issue mockoon/commons-server#1)
• Having a response with empty rules but an AND operator does not interrupt the rules evaluation and does not serve the wrong response anymore. (Issue mockoon/commons-server#6)
• Route path and prefix duplicated slashes are now correctly deduplicated when running the server. (Issue mockoon/commons-server#9)

Thank you

A big thank you to the following people that helped to make Mockoon better:

• @barefootdeveloper: Prevent API prefix forwarding. (Issue #237)
• @davidvieiratrustly: New sequential responses and request number rule. (Issue #459)
• @louiealmeda: New baseUrl helper. (Issue mockoon/commons-server#7)
• @mauriceackel: Empty rules with AND operator issue. (Issue mockoon/commons-server#6)

Welcome to this new release of Mockoon. There are several bug fixes and new features in this version that we hope you will like. But first some news:

• With this release, we decided to take the CLI out of beta 🎉. There is still space for improvements, but it looks stable enough. One breaking change though: Node.js v10 is not supported anymore.

• More users are joining Mockoon's community every day, spreading the word, contributing to the codebase, and giving us invaluable feedback. We are grateful for this. ❤ While we dedicate more and more time to this project, we are looking for sponsors to help us pursue this great endeavor.

• We are interested to learn about specific use cases you or your company encountered. It could even become an article, like Impala's API UX research process we recently published. Contact us!

And now the changelog:

Features:

Custom status codes (Issue #199)

We added some missing status codes to the dropdown, but more importantly, you can now enter custom status codes. Even very invalid ones like 999.

Sequential responses (Issue #459)

A new option is now available to serve different responses sequentially. In the below example, Mockoon will answer with 200 → 404 → 500 → 200 → 404... and so on. The sequence gets reset after restarting the server.

Head over to the sequential responses documentation to learn more about this feature.

Request number response rule (Issue #459)

A new type of rule, "Request number", is now available. It allows you to serve a specific response depending on the index (number) of the entering requests. As for the sequential responses feature, it gets reset when restarting the server.

This example returns a 500 error only for the first call:

While this one returns a 500 error for the first 9 calls:

Head over to the response rules documentation to learn more about this feature.

Misc

• A new baseUrl helper has been added which returns the request's base URL (without the route path): {protocol}://{hostname}:{port}/{prefix}. (Issue mockoon/commons-server#7)

• A new option has been added to prevent forwarding of the API prefix when the proxy mode is enabled. (Issue #237)

  

Improvements:

• To improve the application stability, only one instance can run at a single time. Running a second instance of the application will focus the running instance if any. (Issue #455)

• Multiple headers with the same name are now supported everywhere (route headers, environment headers, proxy request/response headers). This may be a non-standard way of sending the headers (vs comma-separated values) but a common one, especially for the Set-Cookie header. (Issue #318)

• We added more suggestions to the header names and values dropdowns to help you mock faster!

• Thanks to work on issue #199, we improved the look and feel of the HTTP methods dropdown with improved hype (and more accessible) pastel colors.

  

• "Port is invalid" message has been updated to "Port is invalid or access is denied" to give more hints about the potentially reserved ports on Windows. (Issue #463)

Fixes:

• We updated the Faker.js library to its latest version. This indirectly solved the issue with 'internet.avatar' URLs returning a 403. (Issue mockoon/commons-server#1)
• Having a response with empty rules but an AND operator does not interrupt the rules evaluation and does not serve the wrong response anymore. (Issue mockoon/commons-server#6)
• Route path and prefix duplicated slashes are now correctly deduplicated when running the server. (Issue mockoon/commons-server#9)

Thank you

A big thank you to the following people that helped to make Mockoon better:

• @barefootdeveloper: Prevent API prefix forwarding. (Issue #237)
• @davidvieiratrustly: New sequential responses and request number rule. (Issue #459)
• @louiealmeda: New baseUrl helper. (Issue mockoon/commons-server#7)
• @mauriceackel: Empty rules with AND operator issue. (Issue mockoon/commons-server#6)

Welcome to this new release of Mockoon. There are several bug fixes and new features in this version that we hope you will like. But first some news:

• Templating system documentation has been revamped and split into multiple sections. All helpers are now properly documented.
• We also split the route responses documentation into two pages to make it easier to find the response rules documentation.

Features:

• Routes can now be filtered by path and documentation (Issue #257):

  

• Three new string manipulation helpers are now available: indexOf, includes, substr. See documentation for more information. (Issue #413)

Fixes:

• Fix setVar helper not working in block helpers like repeat. (Issue #429)
• Add a new third parameter (boolean) to the body helper to returns the stringified value even if it's a primitive. (Issue #397)
• Add a new third parameter (boolean) to the queryParam helper to returns the stringified value. (Issue #418)
• Proxied binary bodies are no longer converted to UTF-8 strings and are now forwarded "as-is". (Issue mockoon/commons-server#3)
• When switching route responses the body undo state does not contain other routes' body content anymore. (Issue #309)
• Adding a trailing slash to the API prefix do not returns 404s on all endpoints anymore. (Issue #422)

Misc:

• Mockoon is now more secure by a combination of enabling Chrome sandboxing and Electron context isolation. We also disabled Node.js integration and stopped using the remote module in Electron's renderer process. These best practices have been pushed and enabled by default by Electron's team in the most recent versions. We took it on ourselves to try to follow them all and rewrote part of the application architecture. Aside from the improved security and prevention of future vulnerabilities like XSS and RCE, we also saw slightly better performances overall. (Issue #349)
• max-http-header-size which was limited to 8kb is now limited to 16kb thanks to an update to Node.js v14. (Issue #442)

Thank you

A big thank you to the following people that helped to make Mockoon better:

• @mauriceackel: New stringify parameter for body and queryParam helpers. (Issue #397, Issue #418)
• @SimonPStevens: New string manipulation helpers. (Issue #413)

Welcome to this new release of Mockoon. There are several bug fixes and new features in this version that we hope you will like. But first some news:

• The CLI is finally available 🥳 It allows you to easily run your mocks on a server or CI environment. This was our little 2020 challenge and you can learn more about it in this blog post.
• We have a new Discord server. You can use it to ask for help or discuss ideas and improvements (or just say hi 👋), alongside the discussions tabs on the application repository or the CLI repository.
• Our founder @255kb is now full time on the project! 2021 is going to be an exciting year for Mockoon 🚀

And now the changelog:

New features

• Three new helpers are available:

  • concat to create string from multiple strings and variables. (Issue #391) {{ concat 'value1' 2 'value3' ... }}

  • setVar to create string values to be reused elsewhere in the template. (Issue mockoon/commons#8). {{ setVar 'varname' 'value' }} {{ varname }}

  • dateTimeShift to shift a date from x days, months, etc. (Issue #355) {{ dateTimeShift date='2021-01-01' format='yyyy-MM-dd' years=1 months=1 days=1 hours=1 minutes=1 seconds=1 }}

  Please check the documentation for more information on how to use these helpers.

• Body response rules can now be used to match against the entire raw body. To use this feature, just keep the modifier empty. (Issue #271)

  

• You can now duplicate routes from one environment to another. (Issue #308)

  

Improvements

• Route headers and rules tabs now show the totals of each. (Issue #299)
• OpenAPI default responses are now considered as 200 and will get a body example from the available schema. (Issue #378)
• OpenAPI parser is now compatible with Content-type that contains a charset application/json; charset=utf-8. (Issue #379)

Bug fixes

• Fixed a crash when importing OpenAPI specification files with no servers property. (Issue #415)
• Fixed a bug when importing or duplicating an environment with no routes. (Issue #416)
• Some users reported a bug where the main window cannot be maximized in Debian with XFCE. We weren't able to reproduce the issue but we tried to fix it anyway with some black magic. Let us know if things improved or not. (Issue #357)
• Fixed a bug in the response rules interpreter when comparing against null values. (Issue mockoon/commons#16)
• Fixed API prefix and endpoint paths leading and duplicated slashes not being sanitized anymore. (Issue #421)
• The splash screen transparency issue on Linux is no longer there due to use of a new splash screen. (Issue #364)

Misc

• Fine tune some settings to improve the performance. (Issue #376)
• Migrated from Angular 8 (😱) to 11. (Issue #358)

Thank you

A big thank you to the following people that helped to make Mockoon better:

• @bykof: Rules full body match. (Issue #271)
• @izerozlu: Duplicate routes to another environment. (Issue #308)
• @TheDartCode: Rules and headers tabs count. (Issue #299)

Welcome to this new release of Mockoon. There are several bug fixes and new features in this version that we hope you will like. But first some news:

• There is a new tutorials section on the website, where you will be able to learn new mocking tricks.
• The development of the CLI started and is progressing well (we already have a basic version working internally, yay!). It required some heavy refactoring tackled in this version.
• We can now say "we" for real as a second maintainer joined the team for twice the throughput 🚀. You can follow Fabrice on GitHub 🎉.

And now the changelog:

New features

• Route responses can now be randomized. This option available next to the route responses list will have priority over the rules. As a consequence, the CORS icon changed to reuse the "shuffle" icon for this feature. (Issue #269)
• Valid MongoDB ObjectIds can now be generated with a new objectId helper. See the templating documentation for more information. (Issue #342)
• The export menu has a new option to export the currently selected environment only. (Issue #251)
• Environments can now be started/stopped all at once with a new menu option (Action -> Start/stop/reload all environments). (Issue #90)

Improvements

• When auto-mocking from the environment logs, the API prefix is no longer part of the newly created route path. (Issue #333)

Bug fixes

• Fix automated tests not running correctly due to the newly added splash screen. (Issue #341)
• Fix broken layout in some rare cases due to usage of responsive row/col. (Issue #365)

Misc

• Update Mockoon to Electron 10. (Issue #350)
• Update automated tests to Spectron 12 to improve the tests stability. (Issue #350)
• Project was migrated from TSlint to ESlint, in order to reuse the configuration for the commons library and the future CLI. (Issue #360)
• Current application and future CLI's shared code have been extracted in a new library. (Issue mockoon/commons#1).

Thank you

A big thank you to the following people that helped to make Mockoon better:

• @codingcircus: Start all environments menu entry. (Issue #90)
• @gVirtu: Export current environment option. (Issue #251)
• @lukefx: objectId helper. (Issue #342)
• @sleepypikachu: newline and base64 helpers. (Issue #333)
• @Thanakorn-ki: Randomized route responses. (Issue #269)

Welcome to this new release of Mockoon. There are several bug fixes and new features in this version that we hope you will like:

New features

• A JSON body sample is now generated during a Swagger/OpenAPI file import when a schema is present. (Issue #288)
• Response rules can now be interpreted as OR or AND. (Issue #201)
• Rules can now check JSON bodies number and boolean values. (Issue #321)
• Two new helpers are available in the templating system: newline, which inserts the newline character "\n", and base64 inline or block helper to encode all your stuffs. For more information, please refer to the official documentation. (Issue #331)

Bug fixes

• Fix an issue where some helpers (queryParam, body, etc) couldn't be used as switch helper value. (Issue #325)
• Fix crash when importing Swagger files where the host property is missing. (Issue #326)
• Binary files are now properly sent instead of being converted to strings. (Issue #324)
• Windows-like file path (with backslashes) are now compatible with templating helpers C:\Users\username\Desktop\{{ urlParam 'id' }}.json. (Issue #323)
• The environment's logs layout is not broken anymore when displaying long binary bodies. (Issue #335)
• Fixed a silent error when export dialog was canceled. (Issue #337)

UI improvements

• Export menu items are now disabled when there is no environment to export. (Issue #336)
• Route path input now autofocus after adding a new route. (Issue #334)
• Mockoon has a new fancy loading screen 👀 to avoid content flickering during load.

Misc

• Work has started on the CLI (mainly refactoring), but shhh 🤫 don't say it too loud, there is still a long way to go!

Thank you

A big thank you to the following people that helped to make Mockoon better:

• @maillouxc: newline and base64 helpers. (Issue #331)
• @ninjaneer164: AND/OR operator for response rules. (Issue #201)
• @Spissable: Swagger import fix. (Issue #326)

Welcome to this new version we hope you will like. It brings some new features and many new improvements to the templating system and error reporting. The application also has a new documentation section on the official website, which replaces the old tutorials section.

Templating system

• Dummy JSON helpers ({{firstName}}, {{date}}, etc) that could be used in the body have been replaced by Faker.js. This brings a lot more helpers together with many locales that can be selected in the settings. All the old helpers remain compatible and are automatically linked to their Faker.js equivalent. Faker.js helpers use the following syntax: {{faker 'company.companyName'}}, {{faker 'name.firstName'}}, etc (Issue #293)
• Improvements to the body helper:
  • JSON Objects and arrays can now be retrieved from the entering request's body with templating helpers and added to the response body. (Issue #291)
  • The full request's body can now be retrieved with the body helper used with no parameter: {{body}}. This is compatible with any Content-Type. (Issue #276)
  • The body helper has been improved for x-www-url-encoded bodies. Objects and arrays are now supported. (Issue #290)
• Improvements to the queryParam helper: as for the body helper, the queryParam helper can now retrieve paths, arrays, objects, or the full query params object. (Issue #265 )
• Templating can now be disabled for bodies and files content. Head up to the new route response's "Settings" tab. (Issue #129)

For more information about the templating system, please refer to the official documentation.

Errors feedback

Application errors feedback has been greatly improved especially for JSON content (Issue #253):

• All errors, including templating errors, are now reported in the response body.
• Erroneous JSON bodies are now sent in the response to make debugging easier.
• Incoming and outgoing bodies can now be easily viewed in an editor with linting activated in the environment logs ("clock" icon, in the upper right corner). This is especially useful to view the outgoing body built with the templating helpers.
• Templating system errors are now better reported, including for templating used in headers or file path.

Other improvements

Features

• Route responses can now be duplicated by clicking on the "copy" button next to the route response's tabs. (Issue #250)

UI improvements

• Routes and environment logs menus can now be resized. These preferences are automatically saved. (Issue #104)
• Scrollbars now have a lighter color to make them more visible. (Issue #297)
• The "Open in browser" button next to the route path is now always visible but disabled for non GET routes. (Issue #287)
• The file browsing button use has been clarified by adding a tooltip. (Issue #254)
• Scrolling of environments and routes menu has been disabled when duplicating. (Issue #296)

Bug fixes

• Data storage has been improved to better handle crashes and report errors. (Issue #313)
• When serving a file, the environment's Content-Type could override the file's detected mime type. A route Content-Type can still override the detected mime type. Order of precedence: Route's Content-Type > File's mime type > Environment's Content-Type. (Issue #295)
• Application was crashing when using some templating helpers ({{boolean}}). (Issue #285)
• Fixed a bug when binary bodies were truncated for environment logs. (Issue #294)
• The route responses dropdown is now scrollable should you have a lot of items. (Issue #305)
• Environment logs response and request tabs do not scroll with the content anymore. (Issue #311)
• Body editor's tab size is now set to 2 spaces by default. It was previously set to 4, which was inconsistent with other options using 2 spaces. (Issue #312)

Misc

• Demo environment has been updated to better show Mockoon's capabilities. (Issue #300)
• Release notes are now shown on startup after an update. (Issue #302)
• The official website has a new versioned documentation regrouping the old "tutorials". It will be frequently updated to reflect the application evolution and add new topics.

Code enhancements/developer experience

• Environment logs system have been refactored to easier future developments.

Thank you

A big thank you to the following people that helped to make Mockoon better:

• Sotiris Chatzianagnostou (@sotcha): resizing of routes and logs menus (Issue #104)
• izerozlu (@izerozlu): route responses duplication (Issue #250)

Mockoon is now compatible with Swagger/OpenAPI formats both for import and export. This release also packs lots of improvements and some new features:

Features:

• Add support for import/export of Swagger and OpenAPI formats #86
• Environments menu is now smaller and collapsed by default #173 Thanks to @JoshMLeslie
• Specific proxy headers can now be sent to proxied servers and added to their responses #223 Thanks @neocodegs

Improvements:

• A new setting is available to show the complete route path in the menu instead of a truncated version #227 Thanks @johnwest80
• Add a templating helper to read cookies content #235 Thanks @sleepypikachu
• Duplicated routes and environments are now inserted after the original instead of the end of the list #239 Thanks @sleepypikachu
• 404s now returns global environment headers #136 Thanks @abiodunjames
• Proxied responses returning a 404 now correctly propagate proxied environment headers and proxy headers #240 Thanks @abiodunjames
• Etag header has been removed to avoid browser caching #244
• ExpressJS x-powered-by header has been removed
• Environment logs body section is now opened by default #200
• Some application logs can now be found in the Mockoon data folder (available from the Help menu) in the logs folder #262
• Add missing HTTP status code 418 #270
• Increase route responses dropdown width #249

Bugfixes:

• Content-Type was fetched in a case sensitive manner which could lead to JSON parse errors when the route's Content-Type was different from environment's #243
• Using native actions menu could crash the application when no environment was present #233
• Environment logs menu icons are not hidden anymore when long routes are displayed #238 Thanks @sotcha
• Increase server timeout to 1 hour to allow the setup of long latencies #258
• Fix rules always returning true for regexes when the target (body, ...) was undefined #259
• Fix bug with automatically mocked routes hanging when Set-Cookie header was involved #229
• Fix race conditions between environments migration and settings loading #283

Code enhancements/developer experience:

• A Docker image has been created to easier Arch Linux repository updates #231 Thanks @Spissable
• Update application dependencies, review imports, add missing types #275
• Reduce the number of events sent to Google Analytics to avoid exceeding the free tier #277

During this iteration, the import/export system has been revamped. Exports are now independent of Mockoon's version and migrations are played after an import on each environment independently. Which will make data exports easier to share. As before, a single route exported with the "copy to clipboard" feature cannot be imported on a different version.

Features:

• Migrations are now played on each imported environment independently #21
• File export is now fully compatible with a clipboard export (clipboard content can be pasted in a JSON file and imported) #102

Improvements:

• Added a label to better identify route responses #170
• Data are now exported without UUIDs to easier sharing #216
• Avoid possible crashes by preventing using a migrated environment on an older Mockoon version #218
• Added a link in the help menu to open the application data folder #184
• Added a keyboard shortcut to export all environments to JSON #134

Bugfixes:

• Fixed a bug where data were wiped on the second launch of a fresh install #217
• Support Content-Type with charsets (or any additional information after a ;) that were preventing rules to be triggered #214

Development:

• Add Prettier for better code formatting

Special thanks to @gabrielperes97 who worked on most of these great additions 🎉

Mockoon is now available on Arch Linux repository thanks to @Spissable 👍 Install it with yay -S mockoon-bin (or any other AUR helper).

Features:

• Create mock routes from environment logs entries (proxied or not) #139 Thanks @gabrielperes97
• Add possibility to enable/disable a route #106 Thanks @gabrielperes97
• Environment log's bodies from entering request and outgoing responses can now be truncated to desired length in the settings #186 Thanks @gabrielperes97

Improvements:

• Add an icon next to the first route response to better indicate the default one #171
• Update to Electron 7 #183
• New environments (created or duplicated) get next available port or a random one instead of default 3000 #192 Thanks @gabrielperes97
• Mockoon is now available on Arch Linux repository #202 Thanks to @Spissable

Bugfixes:

• Fixes a bug where UI wasn't refreshing after selecting a file to serve #189
• Fixes a bug where adding/removing a route wasn't displaying the "restart needed" indicators #187
• Hide two macOS specific menu entries on Windows and Linux #193

Development:

• Automate binaries build for the 3 targeted platforms #181

Bugfixes:

• Correct bug introduced by v1.5.0 where duplicated routes responses shared some UUID #180

/!\ This release has a bug causing duplicated routes to share the same route responses. Please choose v1.5.1 which solves it. /!\

Mockoon is now available to download through Snap store, together with deb and rpm formats!

Features:

• Add multiple responses per route with possibility to set triggering rules #75
• Add Mockoon's responses log side by side with entering requests #155 & #138 Thanks @gabrielperes97
• Linux users can now download Mockoon in deb and rpm formats alongside AppImage. Mockoon is also available on Snap Store. #168

Improvements:

• Update UI to reflect server binding on multiple network interfaces #99
• Update "someOf" helper to return a string or an array #131
• Make documentation field less confusing by moving it down and rewriting the placeholder #140
• Replace old deprecated wiki "help" menu link with Spectrum community link #135
• MacOS binary has been notarized, which should easier the installation on macOS Mojave #71

Bugfixes:

• Correct bug where body formatting option was not propagating the changes immediately #147

Misc:

• Add multiple responses tutorial on the official website https://mockoon.com/tutorial/multiple-route-responses
• Update request logs to reflect new responses log feature https://mockoon.com/tutorial/incoming-requests-logs

Development:

• Update contribution guidelines
• Add more NPM scripts for local development

Mockoon has moved on a GitHub organization and a new member joined the team. Welcome to @axc450 !

Improvements:

• Add warning next to the path input to prevent accidental declaration with query params #88
• Allow environment headers to override automatic OPTIONS CORS headers #85
• Add JSON pretty print in body #103 (Thanks @vankeer)
• Support Hide / Hide Others / Settings standard shortcuts on macOS #93 (Thanks @axc450)
• Add support for current date time in templating helpers (with now helper) #96
• Add support for x-www-form-urlencoded params in body templating helper #116
• Improve JSON export formatting #123 (Thanks @axc450)

Bugfixes:

• Fixed bug where an error would appear if a user cancels a file select during export #107 (Thanks @axc450)

Misc:

• Application was completely rewritten to use custom Redux-like state management. With this, Mockoon is more stable and app behavior is more predictable #95

Development:

• Use local test data in ./tmp folder instead of default user folder #109
• Add more functional tests

Features:

• Add new environment's headers that are applied to all routes #56
• Add route documentation field #63
• Some files with specific mime types will get their content parsed for templating #80 ( See templating tutorial )

Improvements:

• File input field is now editable and supports templating #52 ( See templating tutorial )
• Add search box in body editor #79
• Automatically select the first item in autocomplete list and correct some display and usability bugs
• New environments will be created with global JSON Content-Type but no Content-Type for routes
• Make routes with spaces work when request in encoded #73
• Added option to add CORS headers to new environment headers #56
• Some minor improvements to the interface mainly for readability
• Allow relative path for files thanks to editable file input #84

Bugfixes:

• Correct crash when declaring routes with invalid regex syntax
• Remove links in changelog modal which were loaded inside Electron's main window
• Solve Linux AppImage icon not showing #72

Misc:

• Start adding functional tests with Spectron for more stability
• Add more tutorials on the official website: templating and headers

Improvements:

• Update all dependencies (Electron 3 shipping with Chrome 66 and Node.js 10, Angular 6)
• Allow parsing of entering request's body event if Content-Type has not been set to JSON #64 & #65 Thanks @alonbhaim
• Enable templating in header values #51 and on any body types (text, HTML, JSON, etc)
• Display version changelog in a modal when clicking on version number

Bugfixes:

• Routes reordering wasn't saved if no other update occured on an environment
• Routes weren't assigned an UUID upon creation which resulted in reordering errors
• Correct bug where body helpers were outputting[object object] when no default value were provided #66
• Display a proper error message and alert when using a templating helper that does not exists instead of failing silently

Misc:

• Mockoon is now available on Homebrew for our macOS friends! Just type brew cask install mockoon.
• Added a Code of conduct
• Started writing some contributing guidelines and help
• Official website has now more content with some tutorials (and more to come)!

Improvements:

• Allow text selection in request logs #54
• Make UI a little bit lighter to improve readability #46

Bugfixes:

• Correct body helper parsing error when request body was not JSON #59
• Correct body not being sent in proxy mode #60
• Correct typos #57 Thanks @mivanov
• Correct bug when trying to pass an invalid Content-Type
• Correct broken analytics tracking since release v1.0.0

Mockoon is now out of beta in a big release with some long awaited features. I hope you will enjoy it 😄

Changelog:

Features:

• Import/Export: All environments can now be imported and exported in a file and each environment and route can be "exported" to clipboard and imported from clipboard (#7) Wiki Page
• Requests log: All entering requests are now logged in each environment (#15) Wiki Page

Improvements:

• Support for OPTIONS requests has been added together with a new environment setting to toggle automatic CORS handling (#40) Wiki Page
• Content-Type handling has been completely rewritten and is now managed by the Headers tab which allows full control (#34) Wiki Page
• Environments and routes can now be reordered with a simple drag and drop (#41)
• Some new helpers were added to the JSON templating (oneOf #36, someOf #36, switch #35 and body #47) Wiki Page
• queryParam and header templating helpers can now have a default value (#44 thanks @nrdobie)
• Multiple consecutive slashes are now rewritten to single slash (no redirection occurs) (#45)

Bugfixes:

• Corrected jumping cursor bug for some fields (route path) (#39)

New pages in the wiki:

• Import / export
• Request logs

Mockoon is now open source! 🎉You can contribute to the development of your favorite tool.

Also I started writing a little wiki to cover Mockoon's most complex / obscure features 😄. Do not hesitate to contribute or ask for specific topics to be covered.

Changelog:

Features:

• JSON body has a new templating system (#3).
• which can also react to request parameters with specific helpers (#4)

Check here for documentation of both features.

Improvements:

• Body length now extends to full height #30
• JSON parsing errors are not better reported

Bugfixes:

• Error handling when serving deleted files has been corrected

Changelog:

Features:

• Proxy mode (#17): if activated all non defined routes are redirected to the specified URL
• HTTPS support (#10): Mockoon now support HTTPS with a self signed certificate
• Added an environment settings tab to set up proxy and HTTPS modes
• Added a welcome screen with analytics opt out (#14 #18)
• Added an application settings screen (currently only with analytics opt out)

Improvements:

• Mockoon have now better and more visible tooltips (#13)

Bugfixes:

• Deleting / adding routes now triggers the "environment needs refresh warning" (#19)
• File download improvement, should correct corrupted files bug (#22)

Changelog:

• move route deletion buttons in context menus #11
• add duplicate environment/route feature #1
• add keyboard shortcuts #5
• Add custom headers autocomplete #2
• Correct navigation bug when removing environments/routes
• automatically scroll when adding custom headers at bottom

Changelog:

• UI small improvements
• rework environments menu to make route prefix more obvious
• prevent page scrolling when using mouse wheel in number inputs
• enable copy paste on MacOS
• auto scroll envs and routes menu to bottom when adding items