Serenity BDD：如何使用 Serenity + selenium 组合下载文件？

Question

我是 Serenity BDD 的新手。通常我所做的是设置 Firefox 首选项。

        FirefoxProfile   profile = new FirefoxProfile();

            //Set Location to store files after downloading.
        profile.setPreference("browser.download.dir", "D:\\WebDriverDownloads");
        profile.setPreference("browser.download.folderList", 2);

        //Set Preference to not show file download confirmation dialogue using MIME types Of different file extension types.
        profile.setPreference("browser.helperApps.neverAsk.saveToDisk", 
            "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet;"); 

        profile.setPreference( "browser.download.manager.showWhenStarting", false );
        profile.setPreference( "pdfjs.disabled", true );

但是在 Serenity 中，我可以在哪里以及如何使用这些配置文件？ 我有什么方法可以在 serenity.properties 文件中设置首选项吗？

Answer 1

Serenity BDD 没有下载文件的特定方法。您将不得不使用驱动程序选项，类似于您通常所做的。

有A short guide on how to configure ChromeDriver in Serenity BDD。 Firefox 和其他浏览器也有类似的做法。

在serenity.properties 中设置这些选项可能并不理想。首先，此文件中的所有内容都必须是静态的 - 您不能根据操作系统或环境使用不同的值。其次，下载路径（例如在 Chrome 中的 chrome_preferences.download.default_directory 选项）必须是全局的——你可能不知道这个值在运行时会是什么。一个潜在的解决方案是在你的 pom 中设置这些；类似：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-failsafe-plugin</artifactId>
  <version>${failsafe.plugin.version}</version>
  <configuration>
    <includes>
      <include>features.*.*Story</include>
    </includes>
    <systemPropertyVariables>
      <chrome_preferences.download.prompt_for_download>false</chrome_preferences.download.prompt_for_download>
      <chrome_preferences.download.default_directory>${project.build.directory}/downloads</chrome_preferences.download.default_directory>
    </systemPropertyVariables>
  </configuration>
  <executions>
    <execution>
      <goals>
        <goal>integration-test</goal>
        <goal>verify</goal>
      </goals>
    </execution>
  </executions>
</plugin>

以上内容将始终使用已知位置下载文件，无论您是在 Window 或 Linux 上运行，还是在本地计算机上或 Jenkins 上运行。要进一步参数化，您可以使用Maven Profiles。

下一个问题将是找到您刚刚下载的文件，以便您可以对它进行一些操作。我尝试了solutions discussed here，但我无法让它们在headless mode 中工作。

最终我想出了这个仅限 Chrome 的解决方案，无论您是通过 Maven 运行还是仅在 IDE 中进行调试，它都应该可以工作。 Firefox 和其他浏览器将使用不同的位置 - 下面的 downloads 位置。

public class DownloadedFile implements Question<File> {

    private static final Logger log = LoggerFactory.getLogger(DownloadedFile.class);

    private DownloadedFile() { }

    @Override
    public File answeredBy(Actor actor) {

        File downloads;
        if (System.getProperty("chrome_preferences.download.default_directory") != null)
            downloads = new File(System.getProperty("chrome_preferences.download.default_directory"));
        else if (System.getProperty("headless.mode") != null && System.getProperty("headless.mode").contentEquals("true"))
            downloads = new File(System.getProperty("user.dir"));
        else
            downloads = new File(System.getProperty("user.home") + "/Downloads");
        log.debug("searching: " + downloads.getPath());
        
        // credit: https://stackoverflow.com/a/286001/3124333
        File[] files = downloads.listFiles(File::isFile);
        File chosenFile = null;
        long lastModifiedTime = Long.MIN_VALUE;
        if (files != null) {
            for (File file : files) {
                if (file.lastModified() > lastModifiedTime) {
                    chosenFile = file;
                    lastModifiedTime = file.lastModified();
                }
            }
        }
        log.debug("found: " + chosenFile.getAbsoluteFile());

        return chosenFile;
    }

    public static Question<File> filename() {

        return new DownloadedFile();
    }
}