feat: add execute commands for removing files

[imurchie]

Adds functions (mobile: deleteFile and mobile: deleteFolder) to remove files/folders from the device or simulator.

Locally this has been tested with an iPhone 7 Plus running iOS 13.1 with

describe('keynote', function () {
  const caps = {
    bundleId: 'com.apple.Keynote',
    platformName: 'iOS',
    platformVersion: '13.1',
    automationName: 'XCUITest',
    udid: 'auto',
    app: null,
    browserName: null,
  }
  let driver;
  before(async function () {
    driver = await initSession(caps);
  });
  after(async function () {
    await deleteSession();
  });

  it('should push a file', async function () {
    const stringData = `random string data ${Math.random()}`;
    const base64Data = Buffer.from(stringData).toString('base64');
    const remotePath = '@com.apple.Keynote:documents/higher.txt';

    await driver.pushFile(remotePath, base64Data);

    const remoteStringData = await pullFileAsString(driver, remotePath);
    remoteStringData.should.equal(stringData);

    await driver.execute('mobile: deleteFile', {remotePath});

    await pullFileAsString(driver, remotePath).should.eventually.be.rejectedWith(/does not exist on the device/);
  });
});

[mykola-mokhnach]

👍

[mykola-mokhnach]

this may potentially damage Simulator FS. Should we rather limit absolute paths, to only known subfolders?

[imurchie]

I'm not sure that it's much of a problem. If people mess things up, oh well?

[mykola-mokhnach]

ok, only full reset will restore the Simulator in such case

[jlipps]

agree w/ @mykola-mokhnach but otherwise +1

[jlipps]

nit: we usually don't have spaces around braces except in imports, i thought.

[mykola-mokhnach]

I think this info message needs some update