Banner

Version 2 of Foal has been released in December 2020 🎉. This series of four articles presents the major new features.

Let’s get started!

#

In version 1, there were many commands to use, and this, in a specific order. Running and generating migrations from model changes required four commands and building the whole application needed three.

In version 2, the number of CLI commands has been reduced and they have been simplified so that one action matches one command.

#

This command generates migrations by comparing the current database schema and the latest changes in your models.

#

This command builds and runs all migrations.

#

If you want to re-build your scripts each time a file is change, you can execute npm run develop in a separate terminal.

#

This command reverts the last executed migration.

#

This command builds the application, the scripts and the migrations. Unit and e2e tests are not included.

#

In version 1, it was possible to add an init method to the AppController class and boot methods in the services to initialize the application. These features needed special options in order to be activated.

Starting from version 2, they are enabled by default.

#

This optional interface allows you to check that the subControllers property has the correct type as well as the init and handleError methods.

#

In version 1, when an error was thrown or rejected in a hook or a controller method, the remaining hook post functions were not executed.

Starting from version 2, the error is directly converted to an HttpResponseInternalServerError and passed to the next post hook functions.

This can be useful in case we want to use exceptions as HTTP responses without breaking the hook post functions.

Example

#

When using the @ValidateMultipartFormDataBody hook to handle file upload, it is now possible to access the file metadata.

Example

Property name Type Description
encoding string Encoding type of the file
filename string|undefined Name of the file on the user’s computer
mimeType string Mime type of the file
path string Path where the file has been saved. If the saveTo option was not provided, the value is an empty string.
buffer Buffer Buffer containing the entire file. If the saveTo option was provided, the value is an empty buffer.

LEAVE A REPLY

Please enter your comment!
Please enter your name here