Lumenci Technical Assessment #3: Firefox iOS
Scenario A (URL)
Function: t extFieldShouldReturn(_ textField: UITextField)
File: Apple Developer Function
Description:
1. Apple Developer Function that will process the user input for the “return” button.
This function is imported with “UIKit” and the developer can write a process that will
start when the user clicks “return” or “go” on the iPhone keyboard. This is used to
initiate the URL loading process.
2. In this case, the “Go” button will initiate textFieldShouldReturn(), which first calls
autoCompletion().
3. Returns a call to autocompleteTextFieldShouldReturn(self) to continue the Webpage
Load Process
------------------------------------------------------------------------------------------------------------------------------------
Function: a
pplyCompletion()
File: [Link]
Description: When a user enters a URL, firefox will autocomplete with suggestions. If the
user clicks “Go” while the autocomplete URL is shown, autoCompletion() will turn the
suggestion into a real text input and complete it for the user. If the user types the URL
themselves, then this will not affect it and the process will continue with the input text.
------------------------------------------------------------------------------------------------------------------------------------
Function: a
utocompleteTextFieldShouldReturn(self)
File: [Link]
Description: This function transfers the text in the URL Bar into a variable, trims the white
space, and calls urlbar() with the “didSubmit” text. The “didSubmit” text distinguishes which
urlbar() function to run and implies the user requested to go to the page via the “go”
button. Lastly, if the URL Bar has no text, then the function will just return false.
------------------------------------------------------------------------------------------------------------------------------------
Lumenci Technical Assessment #3: Firefox iOS
Function: u
rlBar(_ urlBar: URLBarView, didSubmitText text: String)
File: [Link]
Description: Decides what action to take based on the input text in the URL bar. If it passes
as a valid “URL” then it will call “finishEditingAndSubmit()”. If it does not, this function will
then treat it as a search text.
------------------------------------------------------------------------------------------------------------------------------------
Function: U
[Link](text)
File: [Link]
Description: Converts the text into a valid URL for the network to receive. It may add “http”
or any special characters needed to create a valid URL. If it cannot build a URL, the function
will return nil.
------------------------------------------------------------------------------------------------------------------------------------
Function: f inishEditingandSubmit()
File: [Link]
Description: Returns back to the normal browser view and will call
loadRequest(URLRequest(url: url)) to retrieve the web page. This webpage is then shown on
the screen with [Link]()
------------------------------------------------------------------------------------------------------------------------------------
Function: U
RLRequest()
File: Apple Developer Function
Description: Encapsulates the URL and the policies to load it as well as the HTTP request to
get it.
------------------------------------------------------------------------------------------------------------------------------------
Function: l oadRequest()
File: Apple Developer Function
Description: Receives the URL information, obtains the information from the server, loads
the webpage, and navigates to the page.
Lumenci Technical Assessment #3: Firefox iOS
Scenario B (Download)
Function: w
ebView(_ webView: WKWebView, contextMenuConfigurationForElement elementInfo:
WKContextMenuElementInfo, completionHandler: @escaping (UIContextMenuConfiguration?)
File: BrowserViewController+[Link]
Description: Context Menu (“Open in New Tab”, “Bookmark Link”, “Download Link”, etc.) is
triggered when the user performs a long press on an element such as a link. This runs
webView(), which previews the link and displays action buttons for the user. One action
button (UIAction) is the “Download Link” button. When pressed, the program checks if the
link is a blob or not.
● If it is a blob, it will run requestBlobDownload()
● If not. It will begin the download using URLRequest() and webview() (Note: this
webview is a different function from this one)
------------------------------------------------------------------------------------------------------------------------------------
Function: r equestBlobDownload(url: url, tab: currentTab)
File: [Link]
Description: Executes a blob download and then follows the same process as a normal
download (Seen below)
------------------------------------------------------------------------------------------------------------------------------------
Function: w
ebView(_ webView: WKWebView, decidePolicyFor navigationResponse:
WKNavigationResponse, decisionHandler: @escaping (WKNavigationResponsePolicy)
File: BrowserViewController+[Link]
Description: Checks to see if the call was for a download. If it is, the function calls
[Link]() to open the next menu to initiate download.
------------------------------------------------------------------------------------------------------------------------------------
Lumenci Technical Assessment #3: Firefox iOS
Function: D
[Link]()
File: [Link]
Description:
1. Creates an HTTPDownload object to retrieve file name and size and to create a
DownloadTask object
2. Creates one PhotonActionSheetItem object to display the file name and size to the
user if the size variable contains a valid value
3. Creates a second PhotonActionSheetItem object to prompt the user to initiate the
download with a “Download Now” button. This particular object also has code that
will run if the user clicks the button.
4. An action is created to initiate the code if the user clicks “Download Now”. This will
call “[Link](download)” to initiate
the download.
------------------------------------------------------------------------------------------------------------------------------------
Object: HTTPDownload()
File: [Link]
Description:
1. When initialized, this object receives a URLRequest and URLResponse object. It uses
these objects to store file name and file size into class variables to be used by any
calling code (i.e. [Link]()).
2. More importantly, this initializes a download task which is how the device retrieves
the data for the download. The download will not start until resume() is called.
3. A URLSession Object is initialized, which is an API used to download and upload
from URLs.
------------------------------------------------------------------------------------------------------------------------------------
Object: PhotonActionSheetItem()
File: [Link]
Description: When initialized, this object receives attributes that describe a simple widget
popup for the user to interact with when browsing. This can be the title, font, text, position,
or button etc.
Lumenci Technical Assessment #3: Firefox iOS
------------------------------------------------------------------------------------------------------------------------------------
Function: p
resentSheetWith(actions: actions, on: browserViewController, from:
[Link], closeButtonTitle: [Link], suppressPopover: true)
File: [Link]
Description: Displays the desired actions, buttons, and text onto the screen for the user to
interact with. Inputs consist of actions, titles, controller, and cancel action.
------------------------------------------------------------------------------------------------------------------------------------
Function: s [Link](download)
File: [Link]
Description:
1. Clears the Download Queue if it was already empty at the start
2. Updates the total bytes to download. For example, if user was already downloading
an item of 500 bytes and decides to download a 250 byte file, then the total bytes
would be 750 bytes.
3. Resumes the download with [Link](), which belongs to the
HTTPDownload Class and actually starts the download process.
4. calls downloadQueue()
------------------------------------------------------------------------------------------------------------------------------------
Function: d
[Link]()
File: [Link]
Description: Calls the resume() functions associated with the downloadTask that was
created with the download initialization. This begins the download process and saves the
file to the device.
------------------------------------------------------------------------------------------------------------------------------------
Lumenci Technical Assessment #3: Firefox iOS
Function: d
ownloadQueue(_ downloadQueue: DownloadQueue, didStartDownload download:
Download)
File: BrowserViewController+[Link]
Description:
1. Creates a download toast if one does not already exist with DownloadToast(). To
define, a download toast displays the progress of the download to the user.
2. If a download is in progress, the download will just be added to the existing toast.
------------------------------------------------------------------------------------------------------------------------------------
Object: DownloadToast()
File: [Link]
Description: Creates a DownloadToast object with a Download object as a passing
parameter. Using the Download object, it receives values like expected file size and file
name and displays the progress of the download for the user by number of bytes.
------------------------------------------------------------------------------------------------------------------------------------
Function: a
ddDownload()
File: [Link]
Description: Updates the total expected bytes to download to reflect new download. This
updated number will display in the widget
------------------------------------------------------------------------------------------------------------------------------------
Object: downloadTask()
File: Apple Developer Function
Lumenci Technical Assessment #3: Firefox iOS
Description: Creates a task to download a file from a URL. This function takes the contents
of the URL and saves it to the device. This task contains functions to pause, resume, and
cancel download or all downloads.
Lumenci Technical Assessment #3: Firefox iOS
