2017-04-12 00:01:06 +02:00
[[development-plugin-functional-tests]]
=== Functional Tests for Plugins
Plugins use the `FunctionalTestRunner` by running it out of the Kibana repo. Ensure that your Kibana Development Environment is setup properly before continuing.
[float]
==== Writing your own configuration
Every project or plugin should have its own `FunctionalTestRunner` config file. Just like Kibana's, this config file will define all of the test files to load, providers for Services and PageObjects, as well as configuration options for certain services.
To get started copy and paste this example to `test/functional/config.js`:
["source","js"]
-----------
import { resolve } from 'path';
2018-02-07 23:39:53 +01:00
import { resolveKibanaPath } from '@kbn/plugin-helpers';
2018-01-11 09:17:04 +01:00
2017-04-12 00:01:06 +02:00
import { MyServiceProvider } from './services/my_service';
2019-06-28 01:58:40 +02:00
import { MyAppPageProvider } from './services/my_app_page';
2017-04-12 00:01:06 +02:00
// the default export of config files must be a config provider
// that returns an object with the projects config values
export default async function ({ readConfigFile }) {
// read the Kibana config file so that we can utilize some of
// its services and PageObjects
2018-01-11 09:17:04 +01:00
const kibanaConfig = await readConfigFile(resolveKibanaPath('test/functional/config.js'));
2017-04-12 00:01:06 +02:00
return {
// list paths to the files that contain your plugins tests
testFiles: [
resolve(__dirname, './my_test_file.js'),
],
// define the name and providers for services that should be
// available to your tests. If you don't specify anything here
2018-06-27 05:17:41 +02:00
// only the built-in services will be available
2017-04-12 00:01:06 +02:00
services: {
...kibanaConfig.get('services'),
myService: MyServiceProvider,
},
// just like services, PageObjects are defined as a map of
// names to Providers. Merge in Kibana's or pick specific ones
pageObjects: {
management: kibanaConfig.get('pageObjects.management'),
myApp: MyAppPageProvider,
},
// the apps section defines the urls that
// `PageObjects.common.navigateTo(appKey)` will use.
// Merge urls for your plugin with the urls defined in
// Kibana's config in order to use this helper
apps: {
...kibanaConfig.get('apps'),
myApp: {
pathname: '/app/my_app',
}
},
// choose where esArchiver should load archives from
esArchiver: {
directory: resolve(__dirname, './es_archives'),
},
// choose where screenshots should be saved
screenshots: {
directory: resolve(__dirname, './tmp/screenshots'),
}
// more settings, like timeouts, mochaOpts, etc are
// defined in the config schema. See {blob}src/functional_test_runner/lib/config/schema.js[src/functional_test_runner/lib/config/schema.js]
};
}
-----------
From the root of your repo you should now be able to run the `FunctionalTestRunner` script from your plugin project.
["source","shell"]
-----------
2018-01-11 09:17:04 +01:00
node ../../kibana/scripts/functional_test_runner
2017-04-12 00:01:06 +02:00
-----------
[float]
==== Using esArchiver
2020-06-18 22:19:10 +02:00
We're working on documentation for this, but for now the best place to look is the original {kibana-pull}10359[pull request].
2017-04-12 00:01:06 +02:00