ferrum-har 0.1.0 → 0.1.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +18 -7
- data/lib/ferrum/har/page_extension.rb +2 -1
- data/lib/ferrum/har/version.rb +1 -1
- metadata +1 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 46ed855d025e19faa838772982f3b4e4bf6be389750445d91ff45a240e17da2b
|
|
4
|
+
data.tar.gz: 5604f75db7e5fe01ea8d406377c5325ddf59761eef503ebd8e72f581b6cd0017
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: d16fa7164a200c6eecfd06f51f751f335c38222c95077a3a89ca6923557decab9d4a174846c160b36539be22c42651c024194699a7f861816f13badaec3d37bb
|
|
7
|
+
data.tar.gz: 0522dec550b943209ea34edf0991915cd90f23f382e64a8a593eede11f2dfa0fc806534831224e7ca63911654ab95d29acf7751495b238f1f740b81673d2f1c6
|
data/README.md
CHANGED
|
@@ -4,9 +4,10 @@ ferrum-har
|
|
|
4
4
|
[](https://img.shields.io/gem/v/ferrum-har?color=green)
|
|
5
5
|
|
|
6
6
|
[ferrum-har](https://github.com/hlascelles/ferrum-har) is a gem that adds the ability to capture
|
|
7
|
-
HAR files while running tests
|
|
7
|
+
[HAR](https://en.wikipedia.org/wiki/HAR_(file_format)) files while running tests
|
|
8
|
+
using [ferrum](https://github.com/rubycdp/ferrum).
|
|
8
9
|
|
|
9
|
-
|
|
10
|
+
## Installation
|
|
10
11
|
|
|
11
12
|
Add ferrum-har to your Gemfile and `bundle install`:
|
|
12
13
|
|
|
@@ -14,13 +15,14 @@ Add ferrum-har to your Gemfile and `bundle install`:
|
|
|
14
15
|
gem "ferrum-har"
|
|
15
16
|
```
|
|
16
17
|
|
|
17
|
-
|
|
18
|
+
## Usage
|
|
18
19
|
|
|
19
20
|
Use [ferrum](https://github.com/rubycdp/ferrum) as normal and call the `har` method on
|
|
20
|
-
the `page` (or `browser`) object.
|
|
21
|
+
the `page` (or `browser`) object. You will have to use some of the required browser options
|
|
21
22
|
by using the `Ferrum::Har::REQUIRED_BROWSER_OPTIONS` constant.
|
|
22
23
|
|
|
23
|
-
Note, the devtools window in Chrome will be opened
|
|
24
|
+
Note, the devtools window in Chrome will be opened for the duration of the ferrum test run.
|
|
25
|
+
This is mandatory to obtain the HAR from Chrome.
|
|
24
26
|
|
|
25
27
|
```ruby
|
|
26
28
|
browser = Ferrum::Browser.new(
|
|
@@ -33,7 +35,7 @@ page.go_to("https://www.bbc.co.uk")
|
|
|
33
35
|
puts page.har
|
|
34
36
|
```
|
|
35
37
|
|
|
36
|
-
|
|
38
|
+
## How it works
|
|
37
39
|
|
|
38
40
|
Creating a HAR file from [ferrum](https://github.com/rubycdp/ferrum) network objects is complex and
|
|
39
41
|
potentially incompatible with the HAR generated
|
|
@@ -56,7 +58,16 @@ by the `Ferrum::Har::REQUIRED_BROWSER_OPTIONS` constant.
|
|
|
56
58
|
For further reading, a full list of Chrome switches can be found
|
|
57
59
|
[here](https://peter.sh/experiments/chromium-command-line-switches/).
|
|
58
60
|
|
|
59
|
-
|
|
61
|
+
## Upgrading
|
|
62
|
+
|
|
63
|
+
`ferrum-har` uses [semantic versioning](https://semver.org/), so major version changes will usually
|
|
64
|
+
require additional actions to be taken upgrading from one major version to another.
|
|
65
|
+
|
|
66
|
+
## Changelog
|
|
67
|
+
|
|
68
|
+
A full changelog can be found here: [CHANGELOG.md](https://github.com/hlascelles/ferrum-har/blob/master/CHANGELOG.md)
|
|
69
|
+
|
|
70
|
+
## Further work
|
|
60
71
|
|
|
61
72
|
Some ideas for improvements.
|
|
62
73
|
|
|
@@ -14,7 +14,8 @@ module Ferrum
|
|
|
14
14
|
execute("document.ferrumHarRequested = true;")
|
|
15
15
|
base64_encoded_har = Ferrum::Utils::Attempt.with_retry(
|
|
16
16
|
errors: [HarNotReadyError],
|
|
17
|
-
|
|
17
|
+
# 10 seconds
|
|
18
|
+
max: 20,
|
|
18
19
|
wait: 0.5
|
|
19
20
|
) do
|
|
20
21
|
found = evaluate("document.ferrumHar;")
|
data/lib/ferrum/har/version.rb
CHANGED